← 返回目录

MCP Framework

社区

框架 / SDK

用 TypeScript 优雅构建 MCP 服务器的框架

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

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

分类: 开发工具第 339 / 438
Stars: ★ 931 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 6 个月前 ⚠

42FMRS · D

mcp-framework 是一个功能全面的 TypeScript MCP 框架，提供自动发现、多种传输和认证选项，适合快速构建 MCP 服务器。文档详细，社区活跃（由 QuantGeekDev 维护），但需要 TypeScript 知识，且生产环境需注意安全配置。

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

可靠性

3/20

安全与权限

7/20

维护活跃度

7/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 3/20: 评审仅获得 README 与仓库元数据，无法检查源码、测试或 CI。README 声称支持自动发现、stdio/SSE/HTTP-stream 传输以及构建期/运行期校验，但这些行为都无法从证据中验证，因此得分只能落在 happy path 看似合理区间的低位。材料中没有覆盖服务器握手或工具列表的测试或 CI，示例代码中的小问题（奇怪的别名、格式问题）也进一步降低了可信度。
安全与权限 7/20: 现有材料中未发现红线风险：无恶意代码、无凭据窃取、无隐蔽外传、无破坏性默认行为；安装示例仅含占位环境变量，绝无真实密钥。可选的 JWT、API Key、OAuth 2.1 与自定义认证 Provider 是合理的凭据处理设计。扣分点：认证默认可选，实验性 HTTP 传输脚手架默认开启通配 CORS（虽有披露但未默认缓解），且无法审查真实实现以确认最小权限与数据边界。评 7 分。
维护活跃度 7/20: README 与仓库元数据均显示 MIT 许可证，且仓库未被归档。除此之外，材料中没有提交历史、发布记录、变更日志、issue 响应轨迹、依赖更新记录或安全响应渠道（无 SECURITY.md）。star 与 issue 数量仅为发现信号，不加分。项目可能活跃，但缺少版本管理与响应证据，故得分维持中等。评 7 分。
文档质量 13/20: README 层次分明且相当完整：快速开始、CLI 参考、带强制描述的 Zod schema 开发、校验策略、三种传输的完整参数、JWT/API Key/OAuth 2.1/自定义认证（含环境变量与客户端用法）、环境变量表，以及 Claude Desktop/Claude Code 配置示例。CORS 通配脚手架与实验性 HTTP 传输等限制也有披露。扣分点：缺少问题排查章节、未提及速率/成本/运行限制、没有可核验的 CI 或测试产物支持这些声明、项目案例部分过薄、示例代码有细微不一致。评 13 分。
安装易用性 12/20: README 给出了连接客户端的一条简短路径：全局 npm 安装 CLI、mcp create、mcp add tool、npm run build、node dist/index.js，然后把给出的 JSON 粘贴进 Claude Desktop（提供 macOS 与 Windows 路径）。流程清晰、步骤少且有客户端示例。但静态校准规定在缺少提交的测试或 CI 等可验证执行证据时 setup 上限为 15，而材料中并无此类证据；也未给出 Linux 配置、未讨论全局安装的脆弱性，且无法观察到生成服务器实际运行。评 12 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 TypeScript 的开发者
需要快速迭代和自动发现工具/资源/提示的团队
希望为 MCP 服务器添加认证（JWT、API Key、OAuth 2.1）的项目

不适合谁

不使用 TypeScript 的开发者
需要非标准传输或复杂定制认证的极端场景
希望完全控制服务器底层实现的用户

所需权限

文件系统访问（用于日志记录，如启用）
网络访问（用于 SSE/HTTP 传输和认证服务）

风险与副作用

依赖外部 OAuth 提供商时，令牌泄露风险
使用通配符 CORS 可能增加跨域攻击面
跳过工具验证可能导致文档不完整

安装接入

准备工作

运行环境：Node.js

JWT_SECRET 可选密钥 JWT 认证签名密钥，由你自己生成并保存在环境变量中。

API_KEY 可选密钥 API Key 认证使用的密钥，由你自己生成并通过 X-API-Key 请求头提供。

OAUTH_CLIENT_SECRET 可选密钥内省端点的客户端密钥，向授权服务器注册后获得。

其他可选配置项（12 个）

MCP_ENABLE_FILE_LOGGING 可选设为 true 启用文件日志，默认 false，无需外部获取。

MCP_LOG_DIRECTORY 可选日志文件存放目录，默认 logs，无需外部获取。

MCP_DEBUG_CONSOLE 可选设为 true 在控制台显示调试级日志，默认 false。

MCP_SKIP_TOOL_VALIDATION 可选设为 true 可跳过构建时的工具描述校验（不推荐）。

DOCS_BASE_URL 可选 docs MCP 服务器的文档站点地址，例如 https://docs.myapi.com，在你的文档站点 URL 处获取。

OAUTH_AUTHORIZATION_SERVER 可选 OAuth 2.1 授权服务器地址，来自你的身份提供商（如 Auth0、Okta）。

OAUTH_RESOURCE 可选 OAuth 受保护资源的标识 URI，即你的 MCP 服务器地址。

OAUTH_JWKS_URI 可选授权服务器的 JWKS 公钥端点，用于本地 JWT 校验。

OAUTH_AUDIENCE 可选令牌的目标受众（audience）声明，由授权服务器配置。

OAUTH_ISSUER 可选令牌签发者（issuer）标识，由授权服务器配置。

OAUTH_INTROSPECTION_ENDPOINT 可选令牌内省端点地址，由授权服务器提供。

OAUTH_CLIENT_ID 可选内省端点的客户端 ID，向授权服务器注册后获得。

全局安装框架：npm install -g mcp-framework
创建新 MCP 服务器项目：mcp create my-mcp-server
进入项目目录：cd my-mcp-server
服务器即可使用，运行 npm run build 构建。

验证是否装好

运行 npm run build 后执行 node dist/index.js 启动服务器，在 Claude Desktop 等客户端的 MCP 服务器配置中加入该命令，确认客户端工具列表中出现你定义的工具即表示框架工作正常。

常见排障

构建时若出现工具验证错误，请确保每个 Zod 字段都使用 .describe() 添加描述
若服务器无法启动，检查环境变量如 MCP_ENABLE_FILE_LOGGING 是否设置正确
若使用 OAuth 认证，确保所有 OAuth 相关环境变量（如 OAUTH_JWKS_URI）已配置

试试这样问

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

搜索文档中关于认证配置的部分
用 get_page 获取该文档页面的完整 Markdown 内容
列出文档站点的章节结构

使用场景

快速搭建 MCP 服务器原型

为 AI 助手创建自定义工具、资源和提示

集成到 TypeScript 项目中，利用类型安全和自动化验证

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

mcp-framework 是一个用于构建模型上下文协议（MCP）服务器的 TypeScript 框架。它提供开箱即用的架构，支持工具、资源和提示的自动目录发现，多种传输方式（stdio、SSE、HTTP Stream），基于官方 MCP SDK，并内置对 SSE 端点的认证支持（OAuth 2.1、JWT、API Key）。