What is Xmcp?
xmcp 是一个从零开始设计的开源框架,旨在简化 Model Context Protocol (MCP) 工具的构建、测试和发布流程。该框架以开发者体验 (DX) 为核心,旨在消除不必要的复杂性,让您能够专注于使用 TypeScript 创建功能强大、与 AI 深度集成的功能。如果您希望在 MCP 生态系统上进行开发,xmcp 将为您提供所需强大而直观的基础。
主要功能
🗂️ 声明式文件系统路由 只需在您的
tools/目录中创建一个文件,xmcp 就能自动发现并将其注册为新的工具。这种约定优于配置的方法消除了样板代码,让您能够即时构建新功能。⚡ 热重载实现即时开发 修改您的工具、保存文件后,您的开发服务器会立即更新。这种紧密的反馈循环支持快速迭代和调试,助您保持高效的“心流”开发状态。
🛡️ 集成中间件,兼顾安全与逻辑 通过内置且易于配置的 API Key 和 JWT 认证中间件,保护您的 HTTP 端点。您还可以链式调用自定义中间件,以处理日志记录、速率限制或任何其他请求/响应处理需求。
🔌 灵活的部署传输方式 xmcp 开箱即用地支持 HTTP 和 STDIO 两种传输方式。您可以将工具部署为可通过 API 访问的 Web 服务,也可以在本地运行它们,让 AI 代理能够在用户机器上安全地执行操作。
⚙️ 与现有应用无缝集成 将 xmcp 直接集成到您现有的 Next.js 或 Express 应用程序中。这项实验性功能让您无需从头开始,即可为当前项目添加 MCP 功能,从而保留您现有的基础设施。
xmcp 如何解决您的问题:
xmcp 专为实际的、真实世界的应用场景而设计。以下是它表现出色的几个示例:
构建安全、数据驱动的 Web 工具 假设您需要创建一个 AI 工具来查询您公司的私有产品数据库。借助 xmcp,您可以快速定义一个连接到您数据库的
searchProducts工具。利用 HTTP 传输方式和内置的apiKeyAuthMiddleware,您可以将其部署为安全的服务器端端点。现在,您的 AI 应用程序可以调用此工具来获取实时产品信息,并确信访问权限得到了妥善控制。创建本地文件管理助手 假设您想构建一个工具,帮助 AI 代理管理本地机器上的文件——例如,查找并压缩特定文件夹中的所有图片。通过使用 STDIO 传输方式,您可以在本地运行 xmcp 服务器。这使得 AI 能够直接在您的计算机上执行
compressImages工具,安全地执行文件系统操作,而无需将您的文件暴露到网络上。
为什么选择 xmcp?
xmcp 的主要优势在于其坚定不移地致力于提供卓越的开发者体验。尽管其他框架可能提供类似的功能,但 xmcp 在架构设计上旨在最大限度地减少每个开发环节中的摩擦。
默认高效: 基于文件系统的路由和声明式工具定义意味着您可以将更多时间投入到编写业务逻辑上,而减少在配置和样板代码上的精力。
清晰可控: 通过使用 Zod schemas 定义工具的输入参数,您将自动获得类型安全、验证和清晰的文档。这确保了您的工具既健壮又可预测,并且易于人类和 AI 理解。
结论:
xmcp 为在 Model Context Protocol 上开发应用程序提供了清晰、强大且愉快的路径。它提供了您所需的结构和工具,助您构建安全、可扩展且多功能的 AI 工具,无论这些工具是运行在云端还是本地机器上。通过优先考虑开发者体验,xmcp 使您能够更快、更自信地交付创新解决方案。





