Meta API MCP Server

这是一个与模型上下文协议（MCP）协同工作的元API网关服务器。您可以通过MCP将任何API连接到大型语言模型（如Claude、GPT等）。这使得AI助手能够直接与API交互并访问现实世界的数据源。

功能

• 🔄 多API支持：通过单一服务器管理多个API
• 🛠️ 使用JSON配置文件轻松添加API
• 📋 自动将Postman集合转换为MCP工具
• 🔌 全面支持HTTP API（GET、POST、PUT、DELETE、PATCH）
• 🔒 各种认证方法（API密钥、Bearer令牌）
• 📁 从本地文件或远程URL加载配置
• 📑 支持配置文件列表

API编辑工具

已开发出一个用户友好的编辑工具来创建或编辑JSON配置文件：

MCP API编辑器

安装

使用NPM进行全局安装（推荐）

npm install -g meta-api-mcp-server

从源代码安装

git clone https://github.com/savhascelik/meta-api-mcp-server.git
cd meta-api-mcp-server
npm install

使用

作为命令行工具

# 从默认的api-configs/文件夹加载
meta-api-mcp-server

# 指定配置文件（在运行服务器的目录中，应有一个包含此名称和结构化json的文件夹）
meta-api-mcp-server 路径/到/config.json

# 从特定文件夹加载
meta-api-mcp-server 路径/到/configs/

# 从远程URL加载
meta-api-mcp-server https://example.com/api-config.json

# 从远程配置列表加载
meta-api-mcp-server https://example-网址.com/config-list.json

# 从Postman集合加载（您的文件名必须包含“postman”这个词，我有时间会将其绑定到变量上）
meta-api-mcp-server 路径/到/My-API.postman_collection.json

与Cursor或其他MCP客户端一起使用

要连接到像Cursor这样的MCP客户端，请按如下方式配置您的mcp.json文件：

{
  "mcpServers": {
    "myApiServer": { 
      "command": "meta-api-mcp-server",
      "args": [],
      "env": {
         "MCP_CONFIG_SOURCE":"api-configs/flexweather-endpoints.json",
        "API_KEY": "在此处填写您的API密钥"
      }
    }
  }
}

{
  "mcpServers": {
    "myApiServer": { 
      "command": "meta-api-mcp-server",
      "args": [
        "server.js",
        "路径/到/api-config.json"
      ],
      "env": {
        "EXAMPLE_API_KEY": "在此处填写您的API密钥"
      }
    }
  }
}

{
  "mcpServers": {

    "flexweather": { 
      "command": "node",
      "args": [
        "server.js"
        
      ],
      "env": {
        "MCP_CONFIG_SOURCE":"api-configs/flexweather-endpoints.json"
      }
    }
  }
}

{
  "mcpServers": {
     "lemonsqueezy": { 
      "command": "node",
      "args": [
        "server.js"
        
      ],
      "env": {
        "MCP_CONFIG_SOURCE":"api-configs/lemon-squeezy-api.json",
        "LEMON_SQUEEZY_API_KEY": ""
      
      }
    }
  }
}

Postman集合转换

现在使用Meta API MCP Server与现有的Postman集合非常容易！无需编写一行代码即可使用数百个现成的API。

1. 导出您的Postman集合（v2.1.0格式）
2. 使用集合文件启动Meta API MCP Server：

meta-mcp 我的集合.postman_collection.json

3. 服务器将自动：

   • 分析所有端点
   • 检测认证方法
   • 提取路径/查询参数
   • 分析请求体结构
   • 创建MCP工具

4. 将您的API密钥添加到.env文件中（服务器会告诉您使用哪个环境变量）

支持的Postman集合功能

• ✅ 多级文件夹结构
• ✅ Bearer令牌认证
• ✅ API密钥认证
• ✅ 路径参数
• ✅ 查询参数
• ✅ 标头
• ✅ JSON请求体
• ✅ Postman变量（如{{api_url}}）

API编辑工具

已开发出一个用户友好的编辑工具来创建或编辑JSON配置文件：

MCP API编辑器

使用这个网络工具，您可以：

• 通过可视化界面创建API配置
• 编辑现有的JSON配置
• 将Postman集合转换为兼容MCP的配置文件
• 验证配置文件
• 将配置导出为JSON

Postman集合： 您可以将现有的Postman集合上传到编辑工具，并自动将其转换为兼容MCP的配置。这使您可以快速使用现有的集合，而不是从头开始配置API。

编辑器使管理工具名称、参数和其他所有配置选项变得容易。

项目结构

代码库以模块化的方式组织，便于维护和扩展：

meta-api-mcp-server/
├── serve.js
├── api-configs/            # 默认配置目录
└── package.json

API配置文件格式

您可以使用以下JSON格式手动配置API：

{
  "apiId": "我的API",
  "handlerType": "httpApi",
  "baseUrl": "https://api.example.com",
  "authentication": {
    "type": "bearerToken",
    "envVariable": "MY_API_TOKEN"
  },
  "endpoints": [
    {
      "mcpOperationId": "获取用户",
      "description": "获取用户列表",
      "targetPath": "/users",
      “targetMethod”: "GET",
      "parameters": [
        {
          "name": "页码",
          "in": "query",
          "required": false,
          "type": "integer",
          "description": "页码"
        }
      ]
    }
  ]
}

许可证

MIT