MCP Transport Prototype

🚀 mcp-transport-prototype

このプロトタイプは、stdioとSSEの2つのトランスポートプロトコルを介してアクセス可能なカスタムMCPサーバーの構築方法を理解するためのものです。主な目的は、SSEとstdioのトランスポートプロトコルを理解することです。

🚀 クイックスタート

mcp_client.py は、MCPサーバーをSSEモードでテストするためのシンプルなスクリプトです。

# ターミナル1で実行
uv run main.py

# ターミナル2で実行
uv run mcp_client.py

✨ 主な機能

SSE トランスポートプロトコル

サーバー送信イベント（Server-Sent Events, SSE） は、HTTPを介してサーバーからクライアントにリアルタイム更新をプッシュするためのシンプルで効率的な方法です。

• WebSocketとは異なり、SSEは単方向です。つまり、サーバーはクライアントにデータをプッシュできますが、クライアントはサーバーにデータを送信できません。
• 標準HTTP上で動作し、リアルタイム更新、通知、またはストリーミング応答が必要なシナリオに非常に適しています。

stdioと比較すると、SSEはMCPサーバーを個別のHTTPサービスとして実行します。これにより、サーバーからネットワーク上のリアルタイム更新を受信する必要があるWebダッシュボードやブラウザベースのアプリケーションに非常に適しています。

Stdio トランスポートプロトコル

Stdio（標準入出力）は、プログラム間通信の伝統的な方法で、ターミナル、ファイル、または他のプログラムからの標準入力（stdin）を読み取り、ターミナル、ファイル、または他のプログラムに標準出力（stdout）を送信することで実現されます。

• stdin（標準入力）：入力データを受信します。通常はキーボード、ファイル、または別のプログラムからのデータです。
• stdout（標準出力）：出力データを送信します。通常はターミナルに表示されるか、パイプを介して別のプログラムに渡されます。

SSEと比較すると、StdioベースのMCPサーバーは内部ツールに似ています。コマンドラインツール、大規模言語モデル（LLM）エージェント、またはネットワークを使用せずに構造化データを効率的に送受信する必要があるバックグラウンドスクリプトからMCPサーバーを子プロセスとして起動するのに非常に適しています。