← 返回目录
M

MCP Nest

社区
框架 / SDK
用于构建 MCP 服务器的 NestJS 模块

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

分类
开发工具 第 243 / 438
Stars
★ 718 非常热门
传输方式
Streamable HTTP · stdio(本地进程)
运行环境
Node.js
凭据
无需凭据
许可证
MIT
最近提交
51FMRS · D

该服务器适用于希望将其 NestJS 代码库转换为 MCP 服务器的开发者。它在 NestJS 生态系统中提供强大的集成,具有对工具、资源和提示的原生微服务支持。但是,它需要 NestJS 经验,并且可能不适用于非 NestJS 项目。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性
8/20
安全与权限
8/20
维护活跃度
12/20
文档质量
13/20
安装易用性
10/20
查看各项评分依据
可靠性 8/20
源码包含了核心的 McpStrategy 实现和测试,CI 配置存在,但未能执行验证。文档描述了完整的初始化和工具列表流程,但无法确认运行时行为。扣分因为无法执行验证,且测试覆盖虽存在但异常路径未充分展示。
安全与权限 8/20
未发现恶意代码或凭证泄露。工具支持鉴权和 OAuth,但默认配置未强制最低权限,权限控制主要依赖用户实现。扣分因为安全边界和确认机制未完全内建,文档中未明确危险操作确认。
维护活跃度 12/20
有持续提交和发布,issue 有响应,License 为 MIT。但依赖更新未展示,安全响应渠道未明确。扣分因为治理和版本管理还有改进空间。
文档质量 13/20
文档详尽,包含安装、工具、资源、提示、认证和示例,但部分功能(如授权服务器)标记为 Beta,且未覆盖所有故障排除场景。扣分因为未披露限制和故障排除不完整。
安装易用性 10/20
安装步骤清晰,提供了多种传输和框架示例,但依赖较多,配置需手动设置。未包含客户端配置示例。扣分因为设置涉及多个步骤和组件,复杂度和脆弱性中等。

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

查看 FMRS 评分方法 →

选型与风险

适合谁

  • NestJS 开发者希望将 AI 工具无缝集成到现有后端
  • 需要安全、可扩展且可测试的 MCP 服务器的团队
  • 需要微服务架构中细粒度授权和可观测性的项目

不适合谁

  • 非 NestJS 用户,因为它严格基于 NestJS
  • 想要使用不同传输(如 SSE)的开发者(仅支持可流式 HTTP 和 STDIO)
  • 寻求零代码解决方案,希望不编写 TypeScript 或 NestJS 代码即可创建 MCP 服务器的人

所需权限

  • 需要 Node.js 和 npm 环境
  • 运行 STDIO 传输时,进程标准输出必须保留给协议
  • 对于 HTTP 传输,需要可访问的端点;对于外部授权服务器(如 OAuth),可能需要网络访问

风险与副作用

  • 作为较新模块,其 API 可能发生变化(例如从 v1 迁移到 v2)
  • 使用外部授权服务器时,需要正确处理 OAuth 流程
  • 在具有状态会话的延迟/旧客户端上,依赖 ctx.reportProgress 可能无效

安装接入

准备工作

运行环境:Node.js

在您的 NestJS 项目中运行 npm install @rekog/mcp-nest @modelcontextprotocol/server @modelcontextprotocol/core @modelcontextprotocol/node zod@^4。可选地,对于内置授权服务器,安装 @rekog/mcp-nest-auth;对于 TypeORM 存储,安装 @nestjs/typeorm 和 typeorm。然后按照 README 快速入门指南,使用 McpStrategy 和 @McpController 装饰器。

验证是否装好

安装依赖后启动 NestJS 应用,客户端连接 /mcp 端点,应能在工具列表中看到 greeting-tool 并成功调用返回问候文本。

常见排障

  1. 对于 HTTP 传输,请确保在 app.listen() 之前调用 mcp.setHttpAdapter(app.getHttpAdapter()) 和 app.startAllMicroservices()
  2. 对于 STDIO 服务器,禁用日志记录或将日志重定向到 stderr,因为 stdout 用于协议
  3. 验证传输是否包含在传输数组中,且 transport 类型受支持

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 调用 greeting-tool 向 World 打个招呼

使用场景

从现有的 NestJS 应用程序暴露 AI 工具、资源和提示。
在统一代码库中构建企业级 MCP 服务器,同时利用 NestJS 的 DI、守卫、管道和拦截器。
通过可流式 HTTP 和 STDIO 传输,提供同时支持现代和无状态 MCP 协议的端点。

详细介绍

MCP Nest 是一个 NestJS 模块,可让你轻松地创建基于模型上下文协议(MCP)的服务器,以暴露 AI 工具、资源和提示。它作为 NestJS 微服务自定义传输策略运行,使工具、资源和提示成为真正的 @MessagePattern 处理器,因此可以原生使用守卫、管道、拦截器和异常过滤器。它支持可流式 HTTP 和 STDIO 传输,并同时服务 2025 时代协议和无状态的 2026-07-28 修订版。可利用 NestJS 的依赖注入,通过装饰器定义工具、资源和提示,并支持动态能力、资源模板、提示、基于守卫的身份验证、内置或外部授权服务器(OAuth)以及服务器变更。

同类可选方案

Context7 80 · B

Upstash 官方维护,为 AI 编码助手提供实时更新的第三方库文档

★ 62.9k · 工具数 2 与当前对比 →

源版本 ca0060af9772 数据同步于 2026-10-12 查看 FMRS 评分方法