← 返回目录

XMCP

社区

框架 / SDK

用于构建 MCP 服务器的 TypeScript 框架

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

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

分类: 开发工具第 327 / 438
Stars: ★ 1.3k 非常热门
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 7 个月前 ⚠

43FMRS · D

来源显示 xmcp 是由 basement.studio 维护、采用 MIT 许可证的 TypeScript MCP 框架，提供文件系统路由、热重载、中间件、可扩展配置、跨平台部署和 Vercel 支持。来源未提供具体 MCP 工具、传输协议、客户端兼容性或客户端配置示例。

最强项 · 安装易用性 11/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

10/20

文档质量

9/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅提供 README，未缓存 manifest，也没有源代码、测试或 CI 证据，无法验证 MCP 初始化、工具列表握手、工具行为、错误处理或依赖可控性。README 对框架能力的描述使 happy path 看起来合理，但证据不足，因此保守扣分。
安全与权限 8/20: README 提到认证和中间件能力，并提供安全漏洞报告邮箱；但没有源代码或配置示例来验证最小权限、凭据处理、数据边界、外部网络行为或危险操作确认。未发现提示中的红线风险，但缺失证据导致明显扣分。
维护活跃度 10/20: 仓库标记为未归档，提供 MIT 许可证和安全报告渠道；但仅凭给定材料无法核实发布节奏、提交活跃度、问题响应、依赖更新或持续维护情况。许可证和责任渠道支持中等分数，维护证据不足限制得分。
文档质量 9/20: README 提供项目定位、快速启动命令、主要功能、文档链接和安全报告方式；但未提供认证配置、工具参数、限制、成本、平台差异、故障排查或可复核示例。由于完整文档内容未提供，按缺失证据扣分。
安装易用性 11/20: README 给出了 create-xmcp-app 和 init-xmcp 两条初始化路径，并声称支持 Next.js、Express、任意平台及 Vercel；但没有运行时前置条件、主流 MCP 客户端连接配置、认证步骤或端到端验证证据，因此只能给予中等偏上的保守分数。

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

查看 FMRS 评分方法 →

选型与风险

适合谁

熟悉或计划使用 TypeScript 的 MCP 开发者
希望获得热重载和文件系统路由的项目
需要可扩展配置和中间件支持的 MCP 服务器项目

不适合谁

需要一个可直接连接并提供现成工具的 MCP 服务器的用户
寻找已声明具体客户端兼容性、传输方式或内置工具清单的用户

所需权限

README 未说明运行时所需的具体系统、文件或网络权限
如使用身份验证或自定义中间件，权限需求取决于开发者的配置

风险与副作用

这是用于开发 MCP 服务器的框架，不是现成的业务工具服务器
身份验证和自定义中间件需要由开发者配置，配置不当可能影响安全性
部署方式和平台配置可能带来额外运维风险；README 未提供具体安全配置

安装接入

准备工作

运行环境：Node.js

创建新应用：运行 npx create-xmcp-app@latest。也可以在现有 Next.js 或 Express 项目中运行 npx init-xmcp@latest 初始化 xmcp。更多信息请参阅 xmcp.dev 及其文档。

验证是否装好

运行 npx create-xmcp-app@latest 创建项目并启动开发服务器，确认热重载生效且工具从 tools 目录自动注册即可验证安装。

常见排障

确认 Node.js 项目环境及 npx 命令可用
确认新项目使用 create-xmcp-app@latest，现有 Next.js 或 Express 项目使用 init-xmcp@latest
检查 tools 和 prompts 目录是否按文件系统路由约定放置
检查 MCP 服务器配置、中间件和部署平台设置
遇到安全漏洞时联系 [email protected]

使用场景

使用 TypeScript 构建 MCP 服务器

通过文件系统路由自动注册工具和提示

为 MCP 服务器配置身份验证或自定义中间件

将 MCP 服务器部署到不同平台或 Vercel

详细介绍

xmcp 是一个用于使用 TypeScript 构建和发布 MCP 服务器的框架，旨在简化开发流程并降低构建 Model Context Protocol 工具的门槛。