Simple MCP Client Server

🚀 簡單 MCP 客戶端/服務器

本項目提供了一個簡單的 MCP 客戶端與服務器，可幫助你快速搭建相關環境並進行測試。通過以下步驟，你可以在 macOS 和 Linux 系統上完成安裝、啟動和測試工作。

🚀 快速開始

安裝依賴

在 macOS 和 Linux 上安裝 uv：

$ curl -LsSf https://astral.sh/uv/install.sh | sh

安裝完成後，克隆倉庫。

📦 MCP 服務器（標準輸入輸出）

1. 初始化項目

uv init mcp_server
cd mcp_server/
uv run main.py                        # 創建 .venv 環境，然後刪除 main.py 文件

2. 添加依賴

uv add "mcp[cli]" httpx               # MCP 服務器 Python 庫

3. 創建標準輸入輸出服務器實現文件

touch weather_stdio.py

4. 啟動服務器

mcp_server$ uv run weather_stdio.py

5. 使用 VSCode + Cline 測試
   • 將 MCP 服務器添加到 Cline 中：

Cline -> MCP 服務器（靠近 '+' 的圖標）-> 已安裝 -> 添加

- 你會得到一個 JSON 模板 "mcpServers": {}，然後添加新的服務器。以下是 `cline_mcp_settings.json` 示例：

{
  "mcpServers": {
    "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/home/users/tikoehle/mcp_server",
                "run",
                "weather_stdio.py"
            ]
        }
  }
}

- Cline 顯示兩個 `get_*` 工具函數。點擊 '完成' 返回到 Cline 任務輸入，嘗試新的服務器。

6. 測試 輸入調用兩個工具的任務：

"Can you tell me the weather forecast for San Francisco, CA"
"Can you tell me the weather alerts for San Francisco, CA"

使用新的 MCP 'weather' 服務器工具。

⚠️ 重要提示

本地開發的 MCP 服務器不應將消息輸出到標準輸出，因為這會干擾協議操作。

📦 MCP 客戶端

1. 初始化項目

uv init mcp_client
cd mcp_client/
uv run main.py                     # 創建虛擬環境

2. 添加依賴

uv add mcp

3. 創建 MCP 客戶端實現文件

touch client_stdio.py

4. 運行客戶端

mcp_client$ uv run client_stdio.py

📦 MCP 觀察器

1. 安裝 Node.js 和 npm 使用 Node.js 和 npm 的最新版本，安裝命令如下：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts
npm install -g npm@latest
node -v
npm -v

2. 運行觀察器

npm install -g @stellar/mcp-stardust
mcp-stardust

3. 連接 SSE 客戶端/服務器
   • 通過以下命令連接到 SSE 服務器：

curl --location 'http://localhost:8090/api/v1/pops?q=*<POB>' --header 'Connection: close'

- 或者通過 HTTP 連接：

curl --location 'http://localhost:8090/api/v1/pops' --data-raw '{"q":"*<POB>","page":1}' 

📚 問題反饋

在 Python-SDK 中報告問題。