MCP Demo

🚀 🧠 モデルコンテキストプロトコル（MCP）サンプル - Python実装

このリポジトリは、Pythonを使用したシンプルでありながら機能的なモデルコンテキストプロトコル (MCP) のサンプルを提供しています。HTTPベースのJSON-RPCクライアント - サーバーインターフェースを通じて、大規模言語モデル (LLM) エージェントが企業システムと通信する方法を示し、サーバー送信イベント (SSE) もサポートしています。

このテーマをより深く理解するために、私のブログを読むことができます：https://srivatssan.medium.com/model-context-protocol-exhaustively-explained-f5a30a87a3ff?sk=1b971265640303c66b04377371c82102

🚀 クイックスタート

このサンプルを実行するには、以下の手順に従ってください。

1️⃣ サーバーの起動

FastAPIとUvicornをインストールしてください。

pip install fastapi uvicorn

次に、MCPサーバーを起動します。

cd server
uvicorn main:app --reload

これにより、以下のエンドポイントを持つFastAPIサーバーが起動します。

• POST /rpc：ツールリストと呼び出しを処理するJSON-RPCプロセッサ
• GET /events：SSEエンドポイントを模倣し、5秒ごとにハートビートメッセージを送信します。

2️⃣ クライアントの実行

必要なPythonのrequestsパッケージをインストールします。

pip install requests

次に、クライアントを実行してサーバーとやり取りします。

cd client
python main.py

出力結果：

ツール：[{'name': 'greet', 'description': 'Greets the user', ...}]
応答：{'message': 'Hello, Sri!'}

http://localhost:8000/events でハートビートイベントを確認できます。例：

data: {'event': 'heartbeat'}
data: {'event': 'heartbeat'}

✨ 主な機能

• 基本的なMCPサーバーがtools/listとtools/callを通じてツールを公開します。
• クライアントはJSON-RPCリクエストを送信してツールの一覧表示と呼び出しを行います。
• /events SSEエンドポイントを使用してリアルタイム接続を模倣します。
• モジュール化された構造で、resources/ と prompts/ のサポートを拡張できます。

📦 インストール

このサンプルを実行するために必要な依存関係をインストールする手順は、「🚀 クイックスタート」のセクションに記載されています。

💻 使用例

基本的な使用法

サーバーとクライアントの起動手順は、「🚀 クイックスタート」のセクションに記載されています。

高度な使用法

このサンプルを拡張することで、以下の機能を追加できます。

• 異なるモードを持つ追加のツールを追加する。
• resources/list と resources/read をサポートする。
• prompts/get を使用してプロンプトテンプレートを管理する。
• 認証とアクセス制御を実装する。
• サーバーからクライアントへのストリーミング応答を処理する。

📚 ドキュメント

• モデルコンテキストプロトコル（公式サイト）
• JSON-RPC 2.0 仕様
• FastAPI ドキュメント
• サーバー送信イベント (MDN)

📄 ライセンス

READMEにはライセンス情報が記載されていないため、このセクションは省略されます。

このプロジェクトは ❤️ Srivatssan Srinivasan によって作成されました。