HAPI Strava MCP Server

HAPI MCP – 面向模型上下文协议的无头 API

别再为 AI 重写系统。立即将你的 API 转换为 MCP 服务。

HAPI MCP 会自动将你的 OpenAPI 目录转换为 MCP 工具，让设计（OAS/Arazzo）与运行时（Agent/大模型）保持清晰分离。现有 API 即可成为适用于 AI 的工具——无需新增业务逻辑、旁路服务或返工。

主要功能

• 无需重写： 100% 复用现有 API 逻辑。输入 OpenAPI，输出 MCP 工具。无需并行代码库或影子服务。
• 更快实现价值： 几分钟内将规范转换为适用于 Agent 的工具。更新规范，即可立即发布新工具。
• 降低风险： 权限、身份验证、速率限制和可审计性均继承自你的 API——无需额外组件即可实现治理。
• 随业务扩展： runMCP 提供类似无服务器的弹性，并可在需要时长时间运行。冷启动迅速，持续保持热启动以满足吞吐需求。
• 确定性编排： OrcA 可预测地规划并执行多工具任务——无需脆弱的提示词串联。
• 不依赖供应商： 适用于任何 MCP 客户端：ChatGPT、Claude、QBot、chatMCP。OAS + MCP + Arazzo 均可移植。

工作原理

1. 选择 API 规范

   • OpenAPI、Swagger、REST——HAPI CLI 适用于任何 API 规范格式。
   • 支持 OpenAPI 3.0+、REST API、OAuth 2.0 动态客户端注册。

2. 运行一条命令

   • 只需一条简单的 CLI 命令，即可将你的 API 转换为可用的 MCP 服务。
   • 无需复杂设置，无需配置，随处可用，支持跨平台。

3. 立即使用

   • 你的 API 现在可作为工具、AI Agent 或测试接口使用。
   • MCP 服务已就绪，兼容 AI Agent，可用作测试接口，带来友好的开发体验。

可视化流程

API Spec (swagger.json) → HAPI CLI → Usable Tool (AI-ready) ← MCP Clients

[ OpenAPI / Swagger ]       [ HAPI CLI ]        [ MCP Server ]
       (Your API)         →   (Transform)   →   (Usable Tool)
                                                 ↑          ↑
                                                 |          |
                                          [ ChatGPT ]  [ runMCP ]
                                          [ Claude  ]  [ OrcA   ]
                                          [ QBot    ]  [ chatMCP]
                                          [ Agents  ]

HAPI 为谁创造价值

• 高管： 推进 AI 项目，无需大幅增加成本。让团队专注于成果，而不是重写和繁杂的集成。
• 架构师和项目经理： 使用 OpenAPI/Arazzo 进行设计，使用 MCP 运行。清晰的契约、策略继承和版本化工作流有助于降低风险。
• 工程师和运维人员： 一次部署。HAPI Server + runMCP 可扩展工具；QBot/chatMCP 可快速提供反馈；OrcA 可确保执行过程具有确定性。

你的技术栈，开箱即用

• HAPI Server： 自动将 OpenAPI 转换为 MCP 工具——契约始终与你的事实来源保持同步。
• runMCP： 为 MCP 工具提供自动扩缩容的执行和测试；冷启动迅速，工作流长时间运行时也能持续保持热启动。
• QBot： 面向高级用户的 CLI TUI，可直接通过终端或脚本与 MCP 工具交互。
• chatMCP： 原生支持 MCP 的对话式客户端，适用于支持、运维和内部助手。
• OrcA： 为多工具任务提供确定性规划和编排；无需脆弱的提示词串联。
• Agent： 基于标准 API 构建 Agent 系统——无需定制胶水代码。跨平台连接 MCP 客户端。

演示

• 演示播放列表
• 全新的 HAPI MCP YT 频道，提供 API 优先和 MCP 演示

文档

• 浏览文档
• 查看 HAPI Server

常见问题

• 我们需要重写服务吗？
  不需要。HAPI MCP 可将现有的 OpenAPI 规范直接转换为 MCP 工具。身份验证、验证和业务规则都保持不变。

• 这只是另一个 MCP 服务吗？
  它采用 Headless API 模式：API 本身就是运行时。HAPI Server 将其映射为 MCP；runMCP 负责扩展；OrcA 负责编排。无需重复逻辑。

• 哪些客户端可以使用这些工具？
  任何 MCP 客户端：ChatGPT、Claude、QBot、chatMCP、自定义编排器等——设计上不绑定任何供应商。

• 如何保持控制并满足合规要求？
  API 仍是唯一事实来源。策略、RBAC、速率限制和审计日志都会自动贯通；不会产生影子逻辑。

• 安全和隐私方面如何保障？
  API 层会提供范围受限的凭据、逐工具权限和可审计的调用。HAPI 还为受监管环境增添了防护措施和可观测性。

• 我们多久能开始使用？
  你可以在不到五分钟内将第一个 API 转换为 MCP 工具。HAPI CLI 让整个过程快速又轻松。

开始使用

1. 从最新版本安装 HAPI CLI：https://github.com/la-rebelion/hapimcp/releases

2. 只需一条命令，即可将 OpenAPI 规范转换为 MCP 服务：

   hapi serve path/to/your/swagger.json --headless
   

3. 使用任意兼容客户端开始使用 MCP 工具！

4. 查阅文档，了解高级用法和最佳实践。

参与贡献

欢迎贡献！在 GitHub 上发起讨论或提交拉取请求：https://github.com/la-rebelion/hapimcp

许可证

HAPI MCP 基于 MIT License 许可。详情请参阅 LICENSE。