MCP Client X

🚀 MCP 客戶端示例 ☀️

本項目為您展示瞭如何運用模型上下文協議（MCP）實現簡單的客戶端 - 服務器架構。MCP 作為一種標準方式，能將大型語言模型與工具和數據進行有效連接，為您的開發工作提供便利。

🚀 快速開始

先決條件

• Python 3.9+
• uv（Python 包管理器）

安裝

# 安裝依賴項
uv install -e .

運行示例

1. 啟動客戶端（會自動啟動服務器）：

uv run src/client/mcp_client.py

✨ 主要特性

• 演示了帶有自定義工具的 MCP 服務器的創建過程。
• 展示了通過 MCP 客戶端連接到服務器的方法。
• 可調用服務器工具並獲取響應。

📦 安裝指南

依賴安裝

# 安裝依賴項
uv install -e .

運行示例

啟動客戶端（會自動啟動服務器）：

uv run src/client/mcp_client.py

💻 使用示例

基礎用法

客戶端將執行以下操作：

1. 連接到服務器
2. 列出可用工具
3. 調用 BMI 計算器的示例數據
4. 調用天氣工具並提供示例座標

示例響應

可用工具：meta=None nextCursor=None tools=[...]
BMI 計算結果：22.857142857142858
天氣數據：{"current_weather":{"temperature":14.2,"windspeed":12.6, ...}}

📚 詳細文檔

教程視頻

點擊下面的圖片觀看關於 MCP 實現的教程：

項目結構

.
├── pyproject.toml
├── README.md
├── src
│   ├── client
│   │   └── mcp_client.py      # MCP 客戶端實現
│   └── server
│       └── example_server.py  # 帶有工具的MCP服務器
└── uv.lock

服務器實現

該服務器公開了兩個工具：

1. calculate_bmi - 一個簡單的計算器，用於計算身體質量指數（BMI）
2. fetch_weather - 一個異步工具，從外部 API 獲取天氣數據

客戶端實現

客戶端通過標準輸入輸出連接到服務器，初始化會話，並調用服務器的工具。

使用 MCP Inspector 測試

（運行以下命令後訪問 http://localhost:5173）

  ❯ mcp dev src/server/example_server.py
啟動 MCP 檢查工具...
代理服務器在端口 3000 監聽

🔍 MCP 檢查工具已啟動並運行於 http://localhost:5173 🚀
新 SSE 連接
查詢參數：{
  transportType: 'stdio',
  command: 'uv',
  args: 'run --with mcp mcp run src/server/example_server.py',

資源

該項目使用：

• 模型上下文協議 Python SDK
• MCP 官方文檔

📄 許可證

該項目採用 MIT License - 詳細信息請查看 LICENSE 文件