MCP Gateway2

🚀 MCP-Gateway

MCP-Gatewayは、MCPサーバーを統一的に管理するサービスです。これにより、AIエージェントは様々なデータソースに迅速に接続できます。MCPサーバーを通じて、AIエージェントは具体的な接続の詳細を気にすることなく、データベース、REST API、その他の外部サービスに簡単にアクセスできます。

✨ 主な機能

• HTTPインターフェース管理：OpenAPI構造のエクスポート、HTTPをMCPサーバーのYAML形式に変換、およびインターフェースのバージョン管理をサポートします。
  • curlコマンドからHTTPインターフェースへの変換：curlコマンドを標準的なHTTPインターフェースに簡単に変換できます。
  • OpenAPIのインポート/エクスポート：HTTPインターフェースとOpenAPI仕様の間で変換を行い、既存のAPIフレームワークとの統合を容易にします。
• MCPサーバー管理：MCPサーバーのメタデータ管理、複数のHTTP構造を選択してメタデータを更新、MCPサーバーの公開（WebAssemblyにコンパイルして動的にロードできるようにする）、およびバージョン管理をサポートします。
• ルーティング管理：ルーティング設定をサポートします。例えば、xxx/mcp-server/{name}を{name}という名前のMCPサーバーにマッピングできます。

📚 ドキュメント

アーキテクチャ

MCP-Gatewayは3つの核心モジュールで構成されています。

1. HTTPインターフェース管理：APIの設定を定義および管理します。
2. MCPサーバー管理：MCPサーバーのインスタンスを管理し、WebAssemblyにコンパイルし、実行時の処理を行います。
3. ルーティング管理：MCPサーバーのルーティングルールを管理します。

🚀 クイックスタート

前提条件

• Go 1.19以上
• Git

📦 インストール

1. コードをダウンロードします。

git clone [Repository URL]
cd mcp-gateway

2. 依存関係をインストールします。

go mod tidy

3. メインプログラムを実行します。

go run main.go

テスト

以下のコマンドを実行して統合テストを行います。

go test -v ./...

📚 ドキュメント

APIドキュメント

HTTPインターフェースの作成

/api/http-interfacesにPOSTリクエストを送信し、以下のJSONボディを含めることで、HTTPインターフェースを作成できます。

{
  "name": "test-interface",
  "description": "Test interface description",
  "methods": ["GET", "POST"],
  "path": "/test",
  "request": {
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "schema": {
        "$ref": "#/components/schemas/TestRequest"
      }
    }
  },
  "response": {
    "status": 200,
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "schema": {
        "$ref": "#/components/schemas/TestResponse"
      }
    }
  }
}

MCPサーバーの作成

/api/mcp-serversにPOSTリクエストを送信し、以下のJSONボディを含めることで、MCPサーバーを作成できます。

{
  "name": "test-server",
  "description": "Test server description",
  "interface": "test-interface",
  "endpoint": "http://localhost:8080"
}

📄 ライセンス

MIT

参考資料

• Higress MCPクイックスタート
• Higress MCPサーバー
• GJSONテンプレート