← 返回目录

LangGraph.js AI Agent Template

社区

框架 / SDK

基于 LangGraph.js 和 Next.js 的生产级 AI Agent 全栈模板，内置 MCP 动态工具接入

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 134 热门
运行环境: Node.js 18+ · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 48 天前

51FMRS · D

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

最强项 · 文档质量 14/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

12/20

维护活跃度

11/20

文档质量

14/20

安装易用性

9/20

查看各项评分依据

可靠性 5/20: 该仓库本质上是一个 Next.js 全栈“智能体宿主/客户端”模板，通过用户在 UI 中配置的 stdio/HTTP 端点去连接外部 MCP 服务器,它本身并不暴露任何 MCP 工具清单,因此没有可核对的 initialize/tool-list 握手过程,也没有随附的 server manifest(标注为“未缓存”)。README 给出了 docker compose、Prisma 迁移、pnpm dev 等看似可行的启动路径,但仓库没有展示任何 CI workflow 文件或测试脚本(package.json 脚本仅提到 lint/format,未见 test),按静态核查规则在无可验证的测试证据时不得给出高于 12 分,且核心 MCP 握手对象缺失,故进一步下调。
安全与权限 12/20: 敏感凭据(OpenAI/Google/Anthropic API Key、DATABASE_URL)通过 .env.local 管理而非硬编码,属于常规做法,未发现示例中出现真实密钥。项目实现了“人在回路”的工具审批机制(允许/拒绝/修改),对危险操作提供了确认环节,并提供 OAuth 2.0 文档以处理 HTTP MCP 鉴权,这些是积极信号。但同时存在“可选自动批准模式”,一旦在生产环境误开启会绕过人工确认;且该客户端允许用户任意配置 stdio 命令(如文件系统服务器路径)和 HTTP 端点,权限边界与最小权限范围完全取决于终端用户自行配置,仓库未提供任何默认最小权限或沙箱说明。未达到红线级别问题,但确认与权限收敛机制并不完整。
维护活跃度 11/20: 仓库未归档、MIT 许可证清晰,126 星、仅 1 个未关闭 issue,显示项目仍在使用中。但 README 中未见发布版本记录、变更日志、贡献者规模或安全响应渠道的说明;作者以个人身份在文档中多次插入付费咨询/领英引流内容,暗示可能是单人维护,治理与版本化路径不明确。
文档质量 14/20: README 内容较为完整,涵盖快速开始、环境变量配置、架构图、MCP 服务器接入示例、工具审批流程说明,并链接了独立的 ARCHITECTURE.md、API.md、OBSERVABILITY.md、OAUTH.md 等分层文档,且提到通过 Zod 自动生成的 OpenAPI 3.1 文档站点,文档层次较好。但本次仅能看到 README 正文,链接的深入文档内容未随附,工具级别的参数细节、速率限制、成本、故障排查等在正文中并未展开,存在需要跳转验证的隐藏假设,故未给满分。
安装易用性 9/20: 安装步骤较为详细但环节较多:克隆、pnpm install、复制并编辑 .env.local(需准备三选一的模型 API Key)、docker compose 启动 PostgreSQL 与 MinIO、执行 Prisma 生成与迁移、最后启动开发服务器,属于典型的“手动但可行”路径而非几步完成的即插即用式安装。由于没有 CI 或测试证据佐证这些步骤在真实环境中被自动验证过,按静态核查规则上限进一步收紧,同时该仓库并非可被标准 MCP 客户端直接“接入”的 MCP server,缺少面向 MCP 客户端的连接配置示例。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

适合谁

熟悉 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 说明，需注意生产环境的访问控制

安装接入

准备工作

运行环境：Node.js 18+ · Docker

DATABASE_URL 必填密钥 PostgreSQL 连接字符串，本地由 docker compose 启动的数据库使用 localhost:5434；必需。

OPENAI_API_KEY 可选密钥 OpenAI API 密钥，用于 GPT 系列模型；三种模型密钥之一即可运行。

GOOGLE_API_KEY 可选密钥 Google AI API 密钥，用于 Gemini 模型；三种模型密钥之一即可运行。

ANTHROPIC_API_KEY 可选密钥 Anthropic API 密钥，用于 Claude 模型；三种模型密钥之一即可运行。

其他可选配置项（2 个）

DEFAULT_MODEL 可选可选的默认模型名，例如 gpt-4o-mini、gemini-1.5-flash 或 claude-sonnet-4-5。

LANGFUSE_ENABLED 可选可选开关，启用 Langfuse 的 LLM 可观测性追踪，不设置时零开销。

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

验证是否装好

运行 docker compose up -d 启动 PostgreSQL 和 MinIO，执行 pnpm prisma:migrate 并访问 http://localhost:3000；然后在设置的“Add MCP Server”中添加 filesystem 服务器并确认其工具出现在代理的工具列表中。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

通过设置界面添加一个文件系统 MCP 服务器，然后让我列出允许目录中的文件
批准这个工具调用，但把参数里的路径改为桌面文件夹
总结我们上一轮对话中上传的 PDF 的内容
启动一个新对话，使用 Claude 模型并开启自动审批模式

使用场景

快速搭建一个带前端界面的 LangGraph.js AI Agent 原型或产品

为 Agent 动态接入多个第三方 MCP 工具服务器（无需改代码）

需要人工审批工具调用的高风险自动化场景

需要持久化多轮对话记忆与文件上传能力的聊天类应用

详细介绍

这是一个开源的 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 协议官方项目。