MCP Server Client Impl

🚀 🧠 模型上下文協議（MCP）- 服務器-客戶端實現

本項目構建了一個簡潔的 模型上下文協議 (MCP) 系統，涵蓋 MCP 服務器 與 MCP 客戶端，藉助 服務器發送事件 (SSE) 並通過 FastAPI 實現通信。它生動展示了利用 SSE over HTTP 進行輕量級工具調用的過程。

🚀 快速開始

本項目包含 MCP 服務器和 MCP 客戶端兩部分，以下是分別啟動它們的步驟：

啟動 MCP 服務器

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

啟動 MCP 客戶端

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

✨ 主要特性

• 輕量級通信：採用服務器發送事件 (SSE) 結合 FastAPI 實現輕量級工具調用。
• 清晰架構：明確劃分客戶端與服務器，端口和工具定義清晰。
• 簡單易用：提供示例請求，方便快速上手。

🏗️ 架構概述

+-------------+                SSE HTTP                 +-------------+
|             | <------------------------------------>  |             |
| MCP 客戶端  |                                         | MCP 服務器  |
| (FastAPI)   |  /upload_claim  ⇄  upload_claim         | (SSE 工具) |
| 端口: 5000  |  /get_claim_details ⇄ get_claim_details | 端口: 8000  |
+-------------+                                         +-------------+

📦 安裝指南

依賴安裝

在每個目錄中使用以下命令安裝依賴項：

pip install -r requirements.txt

依賴列表

"mcp[cli]"
fastapi
httpx

環境要求

Python 3.10+

💻 使用示例

基礎用法

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"
      }'

📚 詳細文檔

📁 項目結構

.
├── client/                     # MCP 客戶端 (FastAPI 應用)
│   └── main.py
│
├── server/                     # MCP 服務器帶 SSE 工具
│   └── main.py
|
└── README.md
└── requirements.txt

🔧 MCP 服務器

• 端口: 8000
• 框架: FastAPI
• 協議: 服務器發送事件 (SSE)
• 定義的工具:
  • upload_claim
  • get_claim_details

🚀 MCP 客戶端

• 端口: 5000
• 框架: FastAPI
• 端點:
  • POST /upload_claim → 調用 MCP 服務器上的 upload_claim 工具
  • GET /get_claim_details → 調用 MCP 服務器上的 get_claim_details 工具

🔄 通信流程

1. 客戶端 發送一個 SSE HTTP 請求到 MCP 服務器以調用工具。
2. 服務器 處理請求並通過 SSE 流式傳輸響應。

⚠️ 注意事項

⚠️ 重要提示

• 這是一個最小的原型，僅供 開發或教育 使用。
• 數據存儲在內存中，服務器重啟後會重置。
• SSE 用於簡單性和流式兼容性。