🚀 Nchan MCP Transport

🚀 Nchan MCP トランスポート

**Anthropic の MCP（Model Context Protocol）**向けの、高性能な WebSocket／SSE トランスポート層およびゲートウェイです。Nginx、Nchan、FastAPI を活用しています。
Claude やその他の LLM エージェントと連携する、リアルタイムでスケーラブルな AI インテグレーションの構築に役立ちます。

---

✨ これは何ですか？

Nchan MCP Transport は、MCP クライアント（Claude など）が次の方法でツールやサービスと通信するための、リアルタイム API ゲートウェイを提供します。

• 🧵 WebSocket または Server-Sent Events（SSE）
• ⚡️ Streamable HTTP 互換
• 🧠 Nginx + Nchan による低レイテンシーのパブリッシュ／サブスクライブ
• 🛠 バックエンドロジックおよび OpenAPI ツールとの連携に FastAPI を採用

✅ MCP を介して Claude にClaude プラグイン、LLM エージェント、外部 APIを統合する、AI 開発者に最適です。

---

🧩 主な機能

機能	説明
🔄 デュアルプロトコル対応	WebSocket と SSE を自動検出し、シームレスにサポートします
🚀 高性能パブリッシュ／サブスクライブ	Nginx + Nchan を基盤とし、数千の同時接続に対応します
🔌 MCP 準拠のトランスポート	Model Context Protocol（JSON-RPC 2.0）を完全に実装しています
🧰 OpenAPI 連携	任意の OpenAPI 仕様から MCP ツールを自動生成します
🪝 ツール／リソースシステム	Python デコレーターでツールとリソースを登録できます
📡 非同期実行	バックグラウンドタスクキューと、プッシュ通知によるリアルタイムの進行状況更新を提供します
🧱 Docker によるデプロイ	Docker Compose ですぐに起動できます

---

🧠 なぜこれを使うのですか？

MCP を使うと、Claude などの AI アシスタントが外部ツールと通信できます。しかし、次の課題があります。

• ネイティブの MCP は HTTP+SSE を使用しますが、長時間のタスク、ネットワークの不安定さ、高い同時接続数への対応が困難です
• WebSocket は Claude でネイティブにサポートされていないため、このプロジェクトがそのギャップを埋めます
• 純粋な Python によるサーバー側ロジック（FastMCP など）は、高負荷時にスケールしない場合があります

✅ Nchan MCP Transport が提供するもの：

• Web スケールのパフォーマンス（Nginx／Nchan）
• ツール向けの FastAPI ベースのバックエンド
• Claude クライアントへのリアルタイムイベント配信
• Claude とのプラグアンドプレイの OpenAPI 連携

---

🚀 クイックスタート

📦 1. サーバー SDK をインストールする

pip install httmcp

🧪 2. Docker でデモを実行する

git clone https://github.com/yourusername/nchan-mcp-transport.git
cd nchan-mcp-transport
docker-compose up -d

🛠 3. ツールを定義する

@server.tool()
async def search_docs(query: str) -> str:
    return f"Searching for {query}..."

🧬 4. OpenAPI サービスを公開する（任意）

openapi_server = await OpenAPIMCP.from_openapi("https://example.com/openapi.json", publish_server="http://nchan:80")
app.include_router(openapi_server.router)

🖥️ 5. GPTs Actions から MCP へワンクリックでデプロイする

HTTMCP は、GPTs Actions を MCP サーバーに即座にデプロイできる強力な CLI を提供します。

# Installation
pip install httmcp[cli]

# One-click deployment from GPTs Actions OpenAPI spec
python -m httmcp -f gpt_actions_openapi.json -p http://nchan:80

---

📚 ユースケース

• WebSocket／SSE を介した Claude プラグインサーバー
• リアルタイム LLM エージェントのバックエンド（LangChain／AutoGen スタイル）
• Claude を社内 API に接続（OpenAPI 経由）
• MCP 向けの高性能なツール／サービスブリッジ

---

🔒 要件

• Nchan モジュールを搭載した Nginx（Docker イメージにプリインストール済み）
• Python 3.9+
• Docker／Docker Compose

---

🛠 技術スタック

• 🧩 Nginx + Nchan – 持続的な接続管理およびパブリッシュ／サブスクライブ
• ⚙️ FastAPI – バックエンドロジックおよび JSON-RPC ルーティング
• 🐍 HTTMCP SDK – MCP プロトコルを完全に実装
• 🐳 Docker – デプロイに対応

---

📎 キーワード

mcp transport, nchan websocket, sse for anthropic, mcp jsonrpc gateway, claude plugin backend, streamable http, real-time ai api gateway, fastapi websocket mcp, mcp pubsub, mcp openapi bridge

---

🤝 コントリビューション

プルリクエストを歓迎します。改善に協力いただける場合は、課題を報告してください。

• パフォーマンス
• デプロイ
• SDK 連携

---

📄 ライセンス

MIT License