Openapi Client Generator

🚀 OpenAPI 客户端生成器 MCP 服务器

本项目是一个使用 TypeScript 开发的模型上下文协议 (MCP) 服务器，它能够依据 OpenAPI 规范生成 API 客户端，为 API 交互提供便利。

🚀 快速开始

本服务器可根据 OpenAPI / Swagger 规范生成基于 axios 的 API 客户端，用于与 API 进行交互。使用提示词 generate_client 即可为指定的 OpenAPI 规范生成一个 API 客户端。

✨ 主要特性

资源

• 依据 OpenAPI / Swagger 规范，生成基于 axios 的 API 客户端，方便与 API 进行交互。
• 利用 OpenAPI / Swagger 规范来生成客户端。

提示词

• generate_client：为指定的 OpenAPI 规范生成一个 API 客户端。

📦 安装指南

开发环境依赖安装

安装项目所需依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式

带有自动重建功能的开发：

npm run watch

在 Claude Desktop 上使用

要在 Claude Desktop 上使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "openapi-client-generator": {
      "command": "node",
      "args": [
        "< PATH TO >/openapi-client-generator/build/index.js"
      ]
    }
  }
}

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会有挑战。我们推荐使用 MCP 检查器，它作为包脚本可用：

npm run inspector

检查器将提供一个 URL，您可以在浏览器中访问调试工具。

💻 使用示例

基础用法

使用 generate_client 提示词为指定的 OpenAPI 规范生成 API 客户端。

🤝 贡献

欢迎为该项目做出贡献，您可以通过打开问题或提交拉取请求的方式参与。我们欢迎任何与项目目标一致的改进建议或新功能。

📄 许可证

此项目根据 MIT 许可证发布 - 请查看 LICENSE 文件以获取详细信息。

使用 Cline 构建