MCP Server Client Impl

🚀 🧠 モデルコンテキストプロトコル（MCP） - サーバー - クライアント実装

このプロジェクトは、モデルコンテキストプロトコル (MCP) システムのシンプルな実装です。MCP サーバー と MCP クライアント が含まれており、サーバー送信イベント (SSE) を使用して FastAPI を通じて通信します。これは、SSE over HTTP を用いた軽量なツール呼び出しを示しています。

🚀 クイックスタート

この MCP システムを使用するには、まずサーバーとクライアントを起動する必要があります。以下の手順に従って操作してください。

✨ 主な機能

• MCP サーバーと MCP クライアントの通信を SSE over HTTP で実現。
• 軽量なツール呼び出しを展示。

🏗️ アーキテクチャの概要

+-------------+                SSE HTTP                 +-------------+
|             | <------------------------------------>  |             |
| MCP クライアント  |                                         | MCP サーバー  |
| (FastAPI)   |  /upload_claim  ⇄  upload_claim         | (SSE ツール) |
| ポート: 5000  |  /get_claim_details ⇄ get_claim_details | ポート: 8000  |
+-------------+                                         +-------------+

📁 プロジェクト構造

.
├── client/                     # MCP クライアント (FastAPI アプリケーション)
│   └── main.py
│
├── server/                     # SSE ツール付き MCP サーバー
│   └── main.py
|
└── README.md
└── requirements.txt

🔧 技術詳細

🔧 MCP サーバー

• ポート: 8000
• フレームワーク: FastAPI
• プロトコル: サーバー送信イベント (SSE)
• 定義されたツール:
  • upload_claim
  • get_claim_details

▶️ MCP サーバーの起動

cd server
pip install -r requirements.txt
python main.py

🚀 MCP クライアント

• ポート: 5000
• フレームワーク: FastAPI
• エンドポイント:
  • POST /upload_claim → MCP サーバー上の upload_claim ツールを呼び出す
  • GET /get_claim_details → MCP サーバー上の get_claim_details ツールを呼び出す

▶️ MCP クライアントの起動

cd client
pip install -r requirements.txt
python main.py

🔄 通信フロー

1. クライアント が MCP サーバーに SSE HTTP リクエストを送信してツールを呼び出します。
2. サーバー がリクエストを処理し、SSE を通じてレスポンスをストリーミングします。

💻 使用例

基本的な使用法

POST /upload_claim

curl -X POST http://localhost:5000/upload_claim \
  -H "Content-Type: application/json" \
  -d '{
        "emp_id": "12345",
        "claim": "これは仮想的な請求です!"
      }'

POST /get_claim_details

curl -X POST http://localhost:5000/get_claim_details \
  -H "Content-Type: application/json" \
  -d '{
        "claim_id": "12345"
      }'

📦 インストール

このプロジェクトを使用するには、必要な依存関係をインストールする必要があります。各ディレクトリで以下のコマンドを実行してください。

requirements.txt

"mcp[cli]"
fastapi
httpx

pip install -r requirements.txt

⚠️ 重要提示

⚠️ 重要提示

• これは最小限のプロトタイプであり、開発または教育 目的でのみ使用してください。
• データはメモリに保存されるため、サーバーを再起動するとリセットされます。
• SSE は単純性とストリーミング互換性のために使用されています。