Meta API MCP Server

Meta API MCP サーバー

Model Context Protocol（MCP）に対応したメタ API ゲートウェイサーバーです。MCP を介して、あらゆる API を LLM（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

使用方法

コマンドラインツールとして

# Load from default api-configs/ folder
meta-api-mcp-server

# Specify a configuration file (in the directory where you run the server, there should be a folder with this name and structured json in it)
meta-api-mcp-server path/to/config.json

# Load from a specific folder
meta-api-mcp-server path/to/configs/

# Load from a remote URL
meta-api-mcp-server https://example.com/api-config.json

# Load from a remote configuration list
meta-api-mcp-server https://example.com/config-list.json

# Load from a Postman Collection ( your filename must contain the word ‘postman’, I'll bind it to a variable when I have time )
meta-api-mcp-server path/to/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": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "myApiServer": { 
      "command": "meta-api-mcp-server",
      "args": [
        "server.js",
        "path/to/api-config.json"
      ],
      "env": {
        "EXAMPLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "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 コレクションの変換

既存の Postman コレクションを Meta API MCP サーバーで使うのが、とても簡単になりました。コードを一行も書かずに、すぐに使える何百もの API を利用できます。

1. Postman コレクションをエクスポートします（v2.1.0 形式）。
2. コレクションファイルを使って Meta API MCP サーバーを起動します。

meta-mcp my-collection.postman_collection.json

3. サーバーが次の処理を自動的に行います。

   • すべてのエンドポイントを分析します
   • 認証方式を検出します
   • パス／クエリパラメーターを抽出します
   • リクエストボディの構造を分析します
   • MCP ツールを作成します

4. .env ファイルに API キーを追加します（使用する環境変数はサーバーが通知します）。

対応する 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/            # Default config directory
└── package.json

API 設定ファイルの形式

次の JSON 形式を使って、API を手動で設定できます。

{
  "apiId": "my-api",
  "handlerType": "httpApi",
  "baseUrl": "https://api.example.com",
  "authentication": {
    "type": "bearerToken",
    "envVariable": "MY_API_TOKEN"
  },
  "endpoints": [
    {
      "mcpOperationId": "getUsers",
      "description": "Get a list of users",
      "targetPath": "/users",
      "targetMethod": "GET",
      "parameters": [
        {
          "name": "page",
          "in": "query",
          "required": false,
          "type": "integer",
          "description": "Page number"
        }
      ]
    }
  ]
}

ライセンス

MIT