Auto MCP

Auto MCP

Auto MCP のホームページはこちら

あらゆる OpenAPI／Swagger 定義を、ローカル、Claude Desktop 内、またはクラウドですぐに実行できる、機能満載の Model Context Protocol（MCP） サーバーに変換します。

このサービスは Swagger（OpenAPI v2）または OpenAPI v3 ドキュメントを読み込み、ルートをその場で生成し、設定した上流エンドポイントにリクエストをプロキシします。そして、MCP の仕様で定義されている STDIO、HTTP、または SSE トランスポートを使って、それらを MCP 経由で公開します。

---

✨ Auto MCP を選ぶ理由

• ボイラープレート不要 – swagger.json を用意するだけで、すぐに提供を開始できます。
• 柔軟なデプロイ – CLI、常時稼働するデーモン、または Docker／Kubernetes 内で実行できます。
• すべてのトランスポートモードに対応 –
  • stdio（デフォルト）。
  • http - StreamableHttp、最新の MCP プロトコルです。
  • sse – セルフホスト可能な、長時間稼働するイベントソースです。
• 認証方式を選択可能 – ベアラートークン、ベーシック認証、API キー、OAuth2、または認証なしに対応します。
• 実行時設定 – YAML ファイル、CLI フラグ、または環境変数（AUTO_MCP_ を接頭辞として使用）で設定できます。

---

🛠️ Auto MCP の使用方法

MCP との連携に最適なように、Swagger／OpenAPI ファイルを簡単に調整できます。MCP Config Builder では、次の操作ができます。

• エンドポイントの説明を編集して、より明確で役立つドキュメントにできます。
• 不要なルートを除外して、公開する API を整理できます。
• LLM やクライアントに表示されるエンドポイントをプレビューしてカスタマイズできます。
• 調整ファイルを生成（--adjustment-file）し、Auto MCP で使用してカスタマイズを自動的に適用できます。

仕組み

1. MCP Config Builder をインストールします：

   go install ./cmd/mcp-config-builder
   

   これにより、mcp-config-builder バイナリがビルドされ、$GOPATH/bin（通常は ~/go/bin）にインストールされます。このディレクトリが PATH に含まれていることを確認してください。
2. ツールを起動します：

   mcp-config-builder --swagger-file=/path/to/swagger.json
   

3. ユーザーフレンドリーな TUI（ターミナルユーザーインターフェース）で、エンドポイントを対話的に確認・編集します。
4. 調整内容をファイルに保存して、後で使用したり共有したりできます。
5. 調整ファイルを指定して Auto MCP を実行し、カスタマイズを適用します：

   auto-mcp --swagger-file=/path/to/swagger.json --adjustment-file=/path/to/adjustments.json
   

---

📚 使用例

1. 迅速なプロトタイピング： あらゆる REST API を数秒で MCP サーバーとしてラップできます。アイデアの検証や AI ツールの迅速な開発に最適です。

2. レガシーサービスとの連携： 書き換えを行わずに、レガシーシステムや内部システムを MCP エンドポイントとして公開できます。

3. チャットアプリケーションからあらゆるサードパーティ API にアクセス： あらゆるサードパーティ API を MCP ツールに変換し、Claude などの AI アシスタントから利用できるようにします。

4. 最小限のプロキシツール： 検証やロジックをすでに処理している API を auto-mcp でプロキシできます。ラッパーは不要です。

---

🖥️ Claude Desktop 内での実行

次のスニペットを Claude Desktop の設定（⟂ 設定 → MCP サーバー）に追加します：

{
  "mcpServers": {
    "YourMCP": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/Users/you/path/to/swagger.json:/server/swagger.json",
        "ghcr.io/brizzai/auto-mcp:latest"
        "--swagger-file=/server/swagger.json"
      ]
    }
  },
  "globalShortcut": ""
}

Claude はコンテナを必要に応じて起動し、STDIO 経由で接続します。swagger.json のホストパスとイメージタグは、お使いの環境に合わせて置き換えてください。

CLI フラグ

• --mode – server.mode（stdio または sse）を上書きします。
• --swagger-file – OpenAPI ドキュメントへのパス（デフォルト：swagger.json）。
• --adjustment-file - mcp-config-builder の出力で、ルートの説明をフィルタリング／変更します。

詳細な設定ガイドラインについては、CONFIGURATION.md をご覧ください。

---

🔐 OAuth サポート

Auto MCP は、PKCE、動的クライアント登録、および複数のプロバイダー（internal、GitHub、Google）を含む OAuth 2.1 認証をサポートしています。これにより、業界標準の認証フローを使用して MCP サーバーを保護できます。

詳細なセットアップ手順、エンドポイントの説明、テストのヒントについては、OAuth Usage Guide をご覧ください。

---

🐳 Docker での実行

1. ローカルの stdio モードで実行する：

   docker run --rm -i \
     -v $(pwd)/swagger.json:/server/swagger.json \
       ghcr.io/brizzai/auto-mcp:latest \
       --swagger-file=/server/swagger.json \
       --mode=stdio
   

2. リモートの sse／http モードで実行する：

   docker run \
     -v $(pwd)/swagger.json:/server/swagger.json \
       ghcr.io/brizzai/auto-mcp:latest \
       --swagger-file=/server/swagger.json \
       --mode=http
   

同梱の docker-compose.yml はポート 8080 をマッピングし、ログを ./logs に永続化します。

Petshop の例を実行する

Docker を使用して、同梱の Petshop デモを試すことができます。このデモでは、サンプルの設定と API 仕様を使用して、auto-mcp の動作を紹介します。

手順：

1. このリポジトリのルートディレクトリにいることを確認します。
2. 次のコマンドを実行します。

docker run --rm -i \
  -v $(pwd)/examples/petshop/config:/config \
  ghcr.io/brizzai/auto-mcp:latest

• このコマンドは、ローカルマシンの examples/petshop/config ディレクトリを /config として Docker コンテナにマウントします。
• コンテナ内の /config ディレクトリには、次のファイルを配置します。
  • config.yaml：デモのメイン設定ファイル
  • swagger.json：Petshop サービスの API 仕様
  • adjustment.yaml：API に対する任意の調整または上書き

注： examples/petshop/config に配置したファイルは、コンテナ内のデフォルトの config.yaml、swagger.json、adjustment.yaml を上書きします。

このセットアップにより、Petshop デモの設定を簡単にテストおよび変更できます。

すべての設定オプションと環境変数による上書きについては、[docs/CONFIGURATION.md](docs/ CONFIGURATION.md) をご覧ください。

🤝 コントリビューション

コントリビューションに関する詳細なガイドラインについては、CONTRIBUTING.md をご覧ください。

---

📄 ライセンス

Apache License 2.0 License の下で配布されています。詳細については、LICENSE をご覧ください。