← 返回目录
L

LangGraph.js AI Agent Template

社区
基于 LangGraph.js 和 Next.js 的生产级 AI Agent 全栈模板,内置 MCP 动态工具接入
GitHub 源仓库 ↗
★ 130 Stars 分类 · 其他 热门 源版本 2ed0c99b1af1
51FMRS · D
可靠性
5/20
安全与权限
12/20
维护活跃度
11/20
文档质量
14/20
安装易用性
9/20

该仓库是一个功能完善的 LangGraph.js + Next.js Agent 全栈模板,其价值在于作为『MCP 客户端宿主』动态接入外部工具,而非自身作为可被添加的 MCP 服务器;README 未提供服务器清单(manifest)或本项目对外暴露的工具列表,因此工具、传输方式等字段留空,评估基于其公开文档与功能描述。

查看 FMRS 评分方法 →

这是一个开源的 Next.js 全栈模板(agentailor/fullstack-langgraph-nextjs-agent),用于快速构建基于 LangGraph.js 的 AI Agent 应用。它本身并不是一个对外暴露工具的 MCP 服务器,而是一个 MCP 客户端/宿主应用:用户可以在其设置界面中添加任意 stdio 或 HTTP 类型的 MCP 服务器(例如官方 filesystem 服务器),由该应用统一加载、前缀化并调用这些外部工具。项目同时提供人机协同的工具调用审批、基于 PostgreSQL 的持久会话记忆、S3/MinIO 多模态文件上传、SSE 实时流式响应,以及可选的 Langfuse 可观测性。技术栈为 TypeScript、React 19、Next.js、Prisma 与 Tailwind CSS,采用 MIT 许可证,由个人开发者 agentailor(IBJunior)维护,非 LangChain 或 MCP 协议官方项目。

工具能力

暂未整理工具清单。

安装接入

  1. git clone 本仓库并执行 pnpm install;2. 复制 .env.example.env.local,填入 DATABASE_URL 及至少一个模型供应商的 API Key(OpenAI/Google/Anthropic);3. 运行 docker compose up -d 启动 PostgreSQL 与 MinIO;4. 执行 pnpm prisma:generatepnpm prisma:migrate 初始化数据库;5. 运行 pnpm dev 启动开发服务器,访问 http://localhost:3000;6. 如需接入外部工具,在设置页面的 “Add MCP Server” 中配置 stdio 命令或 HTTP MCP 服务器地址。

选型与风险

适合谁

  • 熟悉 TypeScript/Next.js 且希望在其上构建自有 Agent 产品的团队
  • 需要评估或演示 MCP 动态工具加载与人机协同审批机制的开发者
  • 已有 PostgreSQL/Docker 环境、愿意自行部署全栈应用的场景

不适合谁

  • 只想直接在 Claude Desktop 等 MCP 客户端里添加一个『工具服务器』的用户(本项目不是这种即插即用的 MCP server)
  • 不希望自行运维数据库、对象存储和前后端服务的用户
  • 需要官方 LangChain 或 MCP 协议团队维护与支持保障的场景

所需权限

  • 数据库读写权限(PostgreSQL,用于会话历史与 MCP 服务器配置存储)
  • 对象存储读写权限(S3 兼容存储/MinIO,用于文件上传)
  • 出站网络访问,用于调用 OpenAI/Google/Anthropic 等模型 API
  • 按用户配置执行本地命令或访问远程 HTTP 端点的能力(当用户添加 stdio/HTTP 类型的 MCP 服务器时)

风险与副作用

  • 用户可在设置界面添加任意 stdio 命令作为 MCP 服务器,如信任来源不明的命令,存在本地命令执行风险
  • 存在可选的『自动批准』模式,开启后会跳过工具调用的人工审批,放大误操作或恶意工具调用的影响
  • API Key、数据库连接串等敏感信息以环境变量形式存储,需妥善保护 `.env.local`
  • 应用在 `/api-docs` 暴露 OpenAPI 说明,需注意生产环境的访问控制

常见排障

  1. 确认 `.env.local` 中 `DATABASE_URL` 与所选模型的 API Key 已正确配置
  2. 确保已执行 `docker compose up -d` 且 PostgreSQL、MinIO 容器正常运行
  3. 如遇数据库相关报错,检查是否已运行 `pnpm prisma:generate` 与 `pnpm prisma:migrate`
  4. 若使用 Langfuse 可观测性,检查 `LANGFUSE_ENABLED` 及相关环境变量是否按 docs/OBSERVABILITY.md 配置
  5. 添加 MCP 服务器失败时,检查 stdio 命令路径/参数或 HTTP MCP 服务器地址、认证头是否正确

使用场景

快速搭建一个带前端界面的 LangGraph.js AI Agent 原型或产品
为 Agent 动态接入多个第三方 MCP 工具服务器(无需改代码)
需要人工审批工具调用的高风险自动化场景
需要持久化多轮对话记忆与文件上传能力的聊天类应用

支持客户端

暂未确认支持的客户端。