简单的 MCP 客户端/服务器

https://modelcontextprotocol.io/quickstart/server

在 macOS 和 Linux 上安装 uv。

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

然后 git clone 这个仓库。

MCP 服务器 (stdio)

uv init mcp_server
cd mcp_server/
uv run main.py                        # 只是为了创建 .venv，然后删除 main.py

uv add "mcp[cli]" httpx               # MCP 服务器 Python 库

touch weather_stdio.py                # STDIO 服务器实现

启动服务器

mcp_server$ uv run weather_stdio.py

使用 VSCode + Cline 测试

将 MCP 服务器添加到 Cline。

Cline -> MCP Servers (图标靠近 '+') -> Installed -> Add

你会得到一个 json 模板 "mcpServers": {}，然后添加新的服务器。 这是 cline_mcp_settings.json：

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

=> Cline 显示 2 个 get_* 工具函数。 点击 'Done' 返回 Cline 任务输入，尝试新的服务器。

测试

输入一个调用两个工具的任务： "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 服务器不应将消息记录到 stdout，因为这会干扰协议操作。

MCP 客户端

https://modelcontextprotocol.io/quickstart/client

uv init mcp_client
cd mcp_client/
uv run main.py                     # 创建 venv

uv add mcp

touch client_stdio.py              # MCP 客户端实现

运行客户端

uv run client.py path/to/server.py

mcp_client$ uv run client_stdio.py ../mcp_server/weather_stdio.py

MCP 检查器

安装 Node.js

在 MCP 服务器计算上，使用 nvm 和 npm 获取 Linux 的 Node.js (Current)。 https://nodejs.org/en/download

cd $HOME

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

# 下载并安装 Node.js：
nvm install 23

# 验证 Node.js 版本：
node -v # 应该打印 "v23.10.0"。
nvm current # 应该打印 "v23.10.0"。

# 验证 npm 版本：
npm -v # 应该打印 "10.9.2"。

检查本地开发的服务器

mcp_server$ uv run mcp dev ./weather_stdio.py
Starting MCP inspector...
Proxy server listening on port 3000

🔍 MCP Inspector is up and running at http://localhost:5173 🚀

注意：

另一种安装最新版本并启动检查器的方法。

mcp_server$ npx @modelcontextprotocol/inspector@latest

在浏览器中打开 MCP 检查器客户端 UI

http://comp9:5173   --> Connect

注意：

如果 MCP 开发服务器在远程计算上运行，例如 comp9，则 MCP 检查器客户端 UI 需要连接到这台机器。

在浏览器中启动 UI 时，传输类型、命令和参数会显示正确的参数。

Transport Type: STDIO
Command: uv
Arguments: run --with mcp mcp run ./weather_stdio.py

或者

Transport Type: SSE
URL: http://comp9:8001/sse

注意：

MCP 开发工具

mcp_server$ uv run mcp

SSE 客户端/服务器

服务器

mcp_server$ uv run weather_sse.py      # 端口 8001

客户端

mcp_client$ uv run client_sse.py http://comp9:8001/sse

Python-SDK

https://github.com/modelcontextprotocol/python-sdk/

SSE 问题：

https://github.com/modelcontextprotocol/python-sdk/issues/398