Mcp Api Client

MCP API Client（Beta）

一个使用 YAML 配置文件调用 API 的 Model Context Protocol (MCP) 服务。

通过简单的 YAML 配置文件，即可连接 API！🤩

适合：#lazy-programmers #nocode #lowcode #ai-integrators #automation #api-gateway #data-pipelines #rapid-prototyping #llm-integration #makers

如果你不具备使用编程语言高级调用 API 的技能，或者只是想通过 MCP 快速将 AI 模型连接到 API，你一定会喜欢 💖 这个 MCP。

🎬▶️ 示例视频😉✨

观看使用内置测试服务和 Claude 的视频

点赞支持！

在 mcp.so 仓库上给我点个赞，并留下鼓励的话。

……当然！如果能捐款帮我支付咖啡和房租，那就太棒了！🙏🙏

功能

• 使用 YAML 配置多个 API 端点
• 根据 YAML 配置文件自动创建 MCP 工具。
• 根据 YAML 配置文件自动创建 MCP fetch API。
• 支持所有 HTTP 方法（GET、POST、PATCH、PUT、DELETE）[✨部分支持✨]
  • [✅] 不带参数的 GET API
  • [✅] 带查询参数的 GET API
  • [✅] 带路径参数的 GET API
  • [✅] POST API
  • [✅] 带路径参数的 PATCH API
  • [✅] 带参数的 PUT API
  • [✅] 带路径参数的 DELETE API
• 设置 API 请求头 [✨可用✨]
• 设置 API Token [✨ 🫣🔴即将推出✨]
• 敏感数据的环境变量插值 [✨ 🫣🔴即将推出✨]
• 自动从 URL 检测 PATH 参数（例如 /users/{id}）[✨可用✨]
• 自动从 URL 检测 QUERY 参数（例如 /users?page={page}&limit={limit}）[✨可用✨]
• 通过为项目配置特定 API，减少使用的提示词 Token
• ……最棒的是，通过将大模型连接到任意 API，为全人类节省无数时间 👏😎😉

使用场景

• 连接到 N8N、Make.com 或 Zapier webhook：将操作连接到自动化或集成工具，从而在其他平台上执行操作。
• AI 模型集成：无需编写自定义代码，即可快速将大模型或其他 AI 模型连接到外部 API，以获取、丰富数据或执行操作。
• 快速原型开发：使用 YAML 配置构建和测试 API 工作流，非常适合黑客松、演示或概念验证项目。
• 无代码/低代码自动化：让非开发人员通过简单的 YAML 文件和环境变量安全地定义和调用 API。
• 数据管道：将 API 调用编排为 ETL 或数据处理管道的一部分，并利用 MCP 工具实现模块化和复用。
• API 网关：通过统一的 MCP 接口公开多个后端 API，简化下游使用者的集成。
• 安全访问 API：通过环境变量管理密钥和 Token，避免在源代码和 YAML 文件中存放敏感数据。

开始使用

1. 获取默认的 api.yaml。

npx -y mcp-api-client --init

2. 你可以使用 Express 测试服务测试默认的 api.yaml：test/server.js。在另一个终端中运行。

npx -y mcp-api-client --test-server

3. 将 MCP 添加到 Agent 配置文件中。

• Claude Client 设置文件示例：

"mcp": {
    "servers": {
      "mcp-api-client": {
          "command": "npx",
          "args": [
              "-y",
              "mcp-api-client",
              "path-to-api.yaml"
          ]
      },
    }
  }

• Visual Studio Code 设置文件示例：

"mcp": {
    "servers": {
      "mcp-api-client": {
          "command": "npx",
          "args": [
              "-y",
              "mcp-api-client",
              "path-to-api.yaml"
          ]
      },
    }
  }

4. 尽管提问！

YAML 配置文件

每个 API YAML 文件都可以包含 MCP 信息的全局元数据：

metadata: General information about the API set

以及 API 端点定义列表：

apis: A list of API endpoint definitions. Each endpoint should have

API YAML 配置文件示例

metadata:
  name: API Examples
  version: 1.0.0
  description: This file contains examples of various API endpoints for testing purposes.

apis:
  - name: getUser
    url: https://api.example.com/users/{id}
    method: GET
    content:
      headers:
        Accept: application/json
  
  - name: createUser
    url: https://api.example.com/users
    method: POST
    api-token: ${API_TOKEN}
    content:
      headers:
        Content-Type: application/json
      body:
        name: string
        email: string
  ...

完整示例（包含元数据、所有 HTTP 方法和参数类型）请参阅 public/apis.yaml。

来自 .env 的 API_TOKEN（尚未测试！）

创建一个 .env 文件来存放你的 API 令牌：

API_TOKEN=your_api_token_here

Bug 和请求

https://github.com/molavec/mcp-api-client/issues

贡献

1. Fork 此仓库
2. 创建你的功能分支
3. 提交你的更改
4. 将分支推送到远程
5. 创建一个新的 Pull Request

许可证

MIT