🧠 Model Context Protocol (MCP) - Server-Client Implementation

🧠 Model Context Protocol (MCP) - 服务端-客户端实现

这是一个简单的 Model Context Protocol (MCP) 系统，包含一个 MCP 服务和一个 MCP 客户端，通过 FastAPI 使用 Server-Sent Events (SSE) 进行通信。它演示了如何通过 HTTP 上的 SSE 轻量级调用工具。

---

🏗️ 架构概览

+-------------+                SSE HTTP                 +-------------+
|             | <------------------------------------>  |             |
| MCP CLIENT  |                                         | MCP SERVER  |
| (FastAPI)   |  /upload_claim  ⇄  upload_claim         | (SSE Tools) |
| Port: 5000  |  /get_claim_details ⇄ get_claim_details | Port: 8000  |
+-------------+                                         +-------------+

---

📁 项目结构

.
├── client/                     # MCP Client (FastAPI app)
│   └──main.py
│
├── server/                     # MCP Server with SSE tools
│   └──main.py
|
└── README.md
└── requirements.txt

---

🔧 MCP 服务

• 端口：8000
• 框架：FastAPI
• 协议：Server-Sent Events (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": "This is a dummy claim!"
      }'

POST /get_claim_details

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

🧰 要求

Python 3.10+

requirements.txt`

"mcp[cli]"
fastapi
httpx

使用以下命令在每个目录中安装依赖：

pip install -r requirements.txt

---

⚠️ 注意事项

• 这是一个最小化原型，旨在用于开发或教育。
• 数据存储在内存中，服务器重启后会重置。
• 使用 SSE 是为了简化实现并兼容流式传输。

---