Mcp2http

🚀 MCP2HTTP

MCP2HTTPは、標準入出力（stdio）を使用するMCPクライアントを、ステートレスなHTTP MCPサーバーに接続するための最小限の転送アダプターです。このアダプターにより、MCPクライアントはHTTP通信を介してMCPサーバーと接続でき、新しい統合の可能性を開拓します。

🚀 クイックスタート

MCP2HTTPを使用するには、まずMCPクライアントを適切に設定する必要があります。以下のセクションでは、具体的な使用方法を説明します。

✨ 主な機能

クライアント生成のセッション追跡

アダプターは自動的に一意の識別子（UUID）を生成し、各リクエストにSession-Idヘッダーとして含めます。このメカニズムは、1996年に提案されたSession-Id（HTTP標準に正式に組み込まれていない）に似ており、シンプルであり、適切な認証を補完することを目的としています。128ビットの16進UUID形式は、衝突耐性があり、普遍的な識別子標準を利用しているため、ステートレスなHTTP環境でリクエストを関連付けるのに理想的です。セッション追跡が必要ない場合、サーバーはSession-Idヘッダーを完全に無視できます。

機能フィルタリング

アダプターはinitializeレスポンスからサーバーの機能を記録し、宣言されていない機能へのリクエストをブロックします。この機能により、特定の機能のみをサポートするサーバーに対する不必要な負荷を軽減できます。

通知処理

IDのないメッセージ（通知）は自動的に破棄されます。このアプローチは、HTTPのリクエスト/レスポンスアーキテクチャと自然に一致しており、MCPをステートレスなHTTPで実装する場合に合理的な選択となります。

📦 インストール

MCP2HTTPを使用するには、MCPクライアントを以下の形式で呼び出すように構成します。

基本的な使用法

npx -y mcp2http <endpoint-url> ["Header: Value"...]

具体的な設定例

Claude Desktopの設定ファイル（claude_desktop_config.json）では、次のように設定できます。

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp2http",
        "http://localhost:3000/mcp"
      ]
    }
  }
}

追加のHTTPヘッダーの設定

任意の数のHTTPヘッダーを引数として追加することもできます。例えば、認証トークンを含める場合は、次のように設定します。

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp2http",
        "https://example.com/mcp",
        "Authorization: Bearer token123"
      ]
    }
  }
}

⚠️ 重要提示

正常に機能するMCP HTTPエンドポイントが必要です。近日中にサンプルサーバーを提供予定です。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。