MCP API 客户端（测试版）

一个使用YAML配置文件调用API的模型上下文协议（MCP）服务器。

这个服务器允许您通过简单的配置YAML文件连接到API！ 🤩

适合：#懒程序员 #无代码 #低代码 #AI集成者 #自动化 #API网关 #数据管道 #快速原型设计 #LLM集成 #创造者

如果您没有使用编程语言进行高级API调用的技能，或者您只是想使用MCP快速连接您的AI模型与API，您会爱上这个MCP。 💖

🎬▶️ 示例视频😉✨

查看此视频，使用包含的测试服务器和Claude

支持您的点击！

在mcp.so仓库上做出反应并给我一个激励性的评论。

... 是的！ 捐助一些资金来帮助支付我的咖啡和房租将会非常棒！ 🙏🙏

功能

• 使用YAML配置多个API端点。
• 自动从YAML配置文件创建MCP工具。
• 自动从YAML配置文件创建MCP获取API。
• 支持所有HTTP方法（GET, POST, PATCH, PUT, DELETE） [✨部分✨]
  • [✅] 无参数的GET API
  • [✅] 带查询参数的GET API
  • [✅] 带路径参数的GET API
  • [✅] POST API
  • [✅] 带路径参数的PATCH API
  • [✅] PUT API
  • [✅] 带路径参数的DELETE API
• 设置API头 [✨工作✨]
• 设置API令牌 [✨ 🫣🔴即将推出✨]
• 环境变量插值用于敏感数据 [✨ 🫣🔴即将推出✨]
• 自动从URL检测PATH参数（如 /users/{id}）[✨工作✨]
• 自动从URL检测QUERY参数（如 /users?page={page}&limit={limit}）[✨工作✨]
• 减少项目中使用的提示标记设置某些API
• ... 最重要的是，为人类节省无数小时的时间👏😎😉，通过将您的LLM连接到任何API。

使用案例

• 连接到N8N、Make.com或Zapier的webhook：在其他平台中执行动作，连接到自动化或集成工具。
• AI模型集成：快速连接LLMs或其他AI模型到外部API以检索数据、丰富数据或执行操作，无需自定义代码。
• 快速原型设计：使用YAML配置构建和测试API工作流，适用于黑客马拉松、演示或概念验证项目。
• 无代码/低代码自动化：使非开发者能够使用简单的YAML文件和环境变量安全地定义和调用API。
• 数据管道：作为ETL或数据处理管道的一部分编排API调用，利用MCP工具实现模块化和重用。
• API网关：通过统一的MCP接口暴露多个后端API，简化下游消费者的集成。
• 安全API访问：通过环境变量管理密钥和令牌，将敏感数据保留在源代码和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添加到您的代理配置文件中。

• 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: 关于API集的一般信息

以及API端点定义列表：

apis: API端点定义列表。每个端点应具有

示例API YAML配置文件

metadata:
  name: API示例
  version: 1.0.0
  description: 此文件包含各种API端点的示例，用于测试目的。

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
  ...

参见public/apis.yaml以获得带有元数据和所有HTTP方法及参数类型的完整示例。

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

创建一个.env文件用于您的API令牌：

API_TOKEN=your_api_token_here

Bug和请求

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

贡献

1. 分叉仓库
2. 创建您的功能分支
3. 提交更改
4. 推送到分支
5. 创建新的拉取请求

许可证

MIT