MCP API 客户端（测试版）

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

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

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

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

支持

你可以帮助我尽快完成它！

你的帮助真的会激励我在 2025 年 5 月 30 日之前 完成它！

在 mcp.so 仓库 上做出反应并给我留下鼓励的评论。

... 是的。捐赠以帮助我支付咖啡和房租将会非常棒！🙏🙏

功能

• 使用 YAML 配置多个 API 端点
• 从 YAML 配置文件自动创建 MCP 工具
• 从 YAML 配置文件自动创建 MCP 获取 API
• 支持所有 HTTP 方法 (GET, POST, PATCH, PUT, DELETE) [✨部分支持✨]
• 设置 API 标头 [✨即将推出✨]
• 设置 API 路径参数（如 /users/:id）[✨即将推出✨]
• 设置 API 令牌 [✨即将推出✨]
• 用于敏感数据的环境变量插值 [✨即将推出✨]
• 从 URL 模板自动生成参数 [✨即将推出✨]
• ... 最重要的是，通过将你的 LLM 连接到任何 API，为人类节省无数小时的时间 👏😎😉。

用例

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

入门指南

1. 获取默认 api.yaml 的副本。

bash
npx -y mcp-api-client --init

1. 你可以使用 express 测试服务器 test/server.js 测试 默认 api.yaml。在另一个终端中执行。

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

1. 将 MCP 添加到你的代理配置文件中。

• Claude Client 设置文件示例：

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

• Visual Studio Code 设置文件示例：

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

1. 只需询问！

YAML 配置文件

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

yaml
metadata: 关于 API 集合的一般信息
name: API 集合的名称
version: 配置的版本
description: API 集合的描述以下是翻译后的中文技术文档，保留了代码块、链接、格式结构和专业术语的准确性：

以及一个API端点定义列表：

yaml
apis: API端点定义列表。每个端点应包含：

• name: 此API端点的唯一名称
  description: 端点功能的简短描述
  url: 端点URL（目前不支持路径参数如 {id}）
  method: HTTP方法 (GET, POST, PATCH, PUT, DELETE)
  api-token: API令牌（支持环境变量）
  content: 请求配置
  headers: 请求头（键值对）
  query: 查询参数（对于GET或其他方法，作为具有name, type, default, required, description的对象列表）
  body: 请求体模式（对于POST, PUT, PATCH，作为具有name, type, default, required, description的对象列表）

请参阅 public/apis.yaml 获取包含元数据及所有HTTP方法和参数类型的完整示例。

配置示例

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

待办事项

• POST
• PUT
• PATCH
• DELETE
• headers
• API_TOKEN

错误与请求

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

贡献指南

1. Fork仓库
2. 创建你的特性分支
3. 提交你的更改
4. 推送到分支
5. 创建一个新的Pull Request

许可证

MIT