Meta Mcp Proxy

Meta MCP Proxy

複数の MCP サーバーと JavaScript 関数にわたってツールを検出し、実行できる柔軟な Model Context Protocol（MCP）プロキシです。数百ものツールがある場合でも、コンテキストを小さく保てます。 この MCP は、他の MCP（またはライブラリ）のラッパーとして機能し、ローカル RAG（Retrieval Augmented Generation）のような処理を行ってコンテキストサイズを削減します。LLM に 2 つのメソッド（discover と execute）を提供し、discover について簡潔に答えるよう LLM に求めます。execute メソッドはシンプルなプロキシです。

ツールの目的と、どのようなトピックで使うべきかを詳しく説明するため、discoverDescriptionExtras 設定を追加することを強くおすすめします。

機能

• 🌉 統合ツール検出：複数の MCP サーバーにわたってツールを検索します
• 🔌 プロキシ実行：適切なサーバーにツール呼び出しをルーティングします
• 🔍 スマート検索：あいまい検索で目的に合ったツールを見つけます
• 🧩 JavaScript 統合：カスタム JavaScript 関数を MCP ツールとして公開します
• 📝 設定可能：ファイルまたはコマンドライン引数から設定を読み込みます

使い方

🧱 インストール

ファイル ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

次の内容を追加します。

{
  "mcpServers": {
    "mcp-openapi-proxy": {
      "command": "npx",
      "args": ["@nullplatform/meta-mcp-proxy","-f","config.json"]
    }
  }
}

設定ファイルの形式

config.json は次の構造にしてください。

{
  "discoverDescriptionExtras": "Additional description for discovery",
  "discoverLimit": 10,
  "mcpServers": {
    "server-name": {
      "command": "command-to-execute",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "transport": "stdio"
    }
  }
}

例：

{
  "discoverDescriptionExtras": "Api used to manage a pet store with access to pets, pet types, users, orders and store",
  "mcpServers": {
    "mcp-petstore": {
        "command": "uvx",
        "args": ["mcp-openapi-proxy"],
        "env": {
            "OPENAPI_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json",
            "API_KEY": "xxxxx"
       }
    }
  }
}

Claude との 0 ショット会話の例

この例では、API の説明がほとんどないペットストアのデモ設定を使用しています。

ライブラリとして使う

Meta MCP Proxy は、独自の JavaScript アプリケーションでライブラリとして使用することもできます。

import { MCPProxy } from '@nullplatform/meta-mcp-proxy';

// Create a new proxy instance
const mcpProxy = new MCPProxy({
  mcpServers: {
    "my-server": {
      "command": "path/to/server",
      "args": [],
      "env": {}
    }
  },
  discoverLimit: 10
});

// Register a custom JavaScript function
mcpProxy.registerJsFunction(
  "myFunction", 
  "Description of my function",
  {
    properties: {
      param1: {
        type: "string",
        description: "First parameter"
      },
      param2: {
        type: "number",
        description: "Second parameter"
      }
    },
    required: ["param1"]
  },
  async ({ param1, param2 }) => {
    // Implementation goes here
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({ result: `Processed ${param1}` })
        }
      ]
    };
  }
);

// Start the MCP server
await mcpProxy.startMCP();

meta-mcp-proxy をライブラリとして使用して MCP を作成する例

ライセンス

MIT