API配置客户端

一个基于YAML配置文件调用API的模型上下文协议(MCP)服务器,适用于快速连接AI模型与API的无代码/低代码自动化场景。

  • by molavec
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 molavec/mcp-yaml-api

使用说明

MCP API客户端(测试版)

A. 模型上下文协议(MCP)服务器 那 调用API 使用 YAML配置 文件夹。

此服务器允许您使用简单的配置YAML文件连接到API! 🤩

适用于: #lazy-programmers #nocode #lowcode #ai-integrators #automation #api-gateway #data-pipelines #rapid-prototyping #llm-integration #makers

如果你没有 高级API调用技能 使用编程语言,或者你只是想 一种将您的人工智能模型与API连接起来的快速方法 使用MCP,你会爱上它的💖 这个MCP。

🎬▶️ 示例视频😉✨

使用附带的测试服务器和Claude查看此视频

点击支持!

做出反应,并给我一个激励性的评论 mcp.so存储库

…是的!捐款来支付我的咖啡和房租将是惊人的! 🙏🙏

特性

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

用例

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

入门

  1. 获取默认值的副本 api.yaml.
npx -y mcp-api-client --init
  1. 你可以测试 默认api.yaml 使用express测试服务器 test/server.js.在其他终端执行。
npx -y mcp-api-client --test-server
  1. 将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"
          ]
      },
    }
  }

  1. 问吧!

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

看 public/apis.yaml 关于元数据以及所有HTTP方法和参数类型的完整示例。

.env中的API_TOKEN(尚未测试!)

创建一个 .env API令牌的文件:

API_TOKEN=your_api_token_here

Bug和请求

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

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建新的Pull请求

许可证

麻省理工学院