Api Wrapper MCP

🚀 API 包装器 MCP 服务器

这是一个通用的 API 包装器服务器，专为模型上下文协议（MCP）打造。它能让您轻松地把 REST API 包装成 MCP 工具，供 Claude 及其他 MCP 客户端访问，极大提升 API 的使用便捷性和通用性。

🚀 快速开始

配置准备

1. 创建一个 YAML 配置文件来定义您的 API 端点（参见 example-config.yaml）。
2. 设置任何所需的 API 令牌作为环境变量。

运行服务器

使用以下命令构建并运行服务器：

# 构建服务器
go build -o api_wrapper

# 使用配置文件运行
./api_wrapper my-apis.yaml

✨ 主要特性

• 灵活配置：使用 YAML 配置文件，可轻松配置多个 API 端点。
• 请求支持：支持 GET 和 POST 请求，满足不同场景需求。
• 参数管理：具备参数验证和默认值设置功能，保障数据准确性。
• 安全认证：通过环境变量进行身份验证，增强系统安全性。
• 超时控制：可自定义 API 调用超时时间，优化性能。

📚 详细文档

配置格式

配置文件采用 YAML 格式，其结构如下：

# 服务器信息
server:
  name: "API 网关 MCP"
  description: "通用 API 网关，将 REST API 包装为 MCP 工具"
  version: "1.0.0"

# 身份验证
auth:
  token_env_var: "API_GATEWAY_TOKEN"  # 环境变量中的 API 令牌

# 工具定义
tools:
  - name: "tool-name"
    description: "工具描述"
    endpoint: "https://api.example.com/endpoint"
    method: "POST"  # 或 "GET"
    timeout: 30  # 秒为单位
    template: |
      {
        "param1": "{{variable1}}",
        "param2": {{variable2}}
      }
    # 对于 GET 请求，使用 query_params
    query_params:
      param1: "{{variable1}}"
      param2: "{{variable2}}"
    parameters:
      variable1:
        type: "string"
        description: "变量 1 的描述"
        required: true
      variable2:
        type: "number"
        description: "变量 2 的描述"
        default: 10

与 Claude Desktop 集成

若要与 Claude Desktop 集成，需在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "api-wrapper": {
      "command": "path/to/api_wrapper",
      "args": ["path/to/your-config.yaml"],
      "env": {
        "API_GATEWAY_TOKEN": "your-api-token"
      }
    }
  }
}

示例

您可以查看 example-config.yaml 以获取 API 配置示例。

环境变量

• 使用环境变量中指定的字段设置主要身份验证令牌：auth.token_env_var。
• 您也可以在模板中引用其他环境变量，使用 {{env:VARIABLE_NAME}} 语法。