适合谁
- 使用 TypeScript 的开发者
- 需要快速迭代和自动发现工具/资源/提示的团队
- 希望为 MCP 服务器添加认证（JWT、API Key、OAuth 2.1）的项目
M
42FMRS · D
mcp-framework 是一个功能全面的 TypeScript MCP 框架，提供自动发现、多种传输和认证选项，适合快速构建 MCP 服务器。文档详细，社区活跃（由 QuantGeekDev 维护），但需要 TypeScript 知识，且生产环境需注意安全配置。
mcp-framework 是一个用于构建模型上下文协议（MCP）服务器的 TypeScript 框架。它提供开箱即用的架构，支持工具、资源和提示的自动目录发现，多种传输方式（stdio、SSE、HTTP Stream），基于官方 MCP SDK，并内置对 SSE 端点的认证支持（OAuth 2.1、JWT、API Key）。
工具能力
暂未整理工具清单。
安装接入
- 全局安装框架：npm install -g mcp-framework
- 创建新 MCP 服务器项目：mcp create my-mcp-server
- 进入项目目录：cd my-mcp-server
- 服务器即可使用，运行 npm run build 构建。
选型与风险
不适合谁
- 不使用 TypeScript 的开发者
- 需要非标准传输或复杂定制认证的极端场景
- 希望完全控制服务器底层实现的用户
所需权限
- 文件系统访问（用于日志记录，如启用）
- 网络访问（用于 SSE/HTTP 传输和认证服务）
风险与副作用
- 依赖外部 OAuth 提供商时，令牌泄露风险
- 使用通配符 CORS 可能增加跨域攻击面
- 跳过工具验证可能导致文档不完整
常见排障
- 构建时若出现工具验证错误，请确保每个 Zod 字段都使用 .describe() 添加描述
- 若服务器无法启动，检查环境变量如 MCP_ENABLE_FILE_LOGGING 是否设置正确
- 若使用 OAuth 认证，确保所有 OAuth 相关环境变量（如 OAUTH_JWKS_URI）已配置
使用场景
快速搭建 MCP 服务器原型
为 AI 助手创建自定义工具、资源和提示
集成到 TypeScript 项目中，利用类型安全和自动化验证
支持客户端
Claude Desktop完整支持