MCP 101

FastMCP演示

带有stdio和HTTP传输的最小FastMCP演示。

安装

uv sync

文件

• server_stdio.py -MCP服务器（stdio传输），提供 add 和 subtract 工具
• server_http.py -MCP服务器（HTTP传输），提供 multiply 工具，支持SSE（传统）和流式HTTP
• test_server.py -自动化测试

测试

测试方法

运行测试

# Without HTTP server (in-memory + subprocess)
uv run pytest test_server.py -q -k "not network"

# With Streamable HTTP server (test_http_network)
uv run python server_http.py  # in another terminal
uv run pytest test_server.py -q -k "not sse"

# With SSE server (test_sse_network)
uv run python server_http.py --transport sse  # in another terminal
uv run pytest test_server.py -q

使用Claude代码进行测试

该项目包括 .mcp.json （项目级配置，仅在从此目录启动Claude Code时有效），有两个服务器配置：

• demo-stdio -由Claude Code自动启动
• demo-http -需要先手动启动服务器

stdio服务器

claude

进入会话后，键入 /mcp 为了验证，然后进行测试：

Use the add tool to calculate 2 + 3

HTTP服务器

先启动服务器：

# Streamable HTTP (recommended)
uv run python server_http.py

# Or SSE (legacy)
uv run python server_http.py --transport sse

然后在克劳德代码中：

Use the multiply tool to calculate 2 * 3

使用Codex CLI进行测试

Codex CLI通过全局配置支持MCP(~/.codex/config.toml).尚不支持项目级配置(功能请求).

stdio服务器

codex mcp add demo-stdio -- uv run python server_stdio.py

HTTP服务器

# Start server first
uv run python server_http.py

# Add HTTP server with url parameter
codex mcp add demo-http --url http://localhost:8000/mcp

注：使用 --url HTTP服务器的标志，不是 -- 一个命令。这 --url 标志告诉Codex通过HTTP直接连接。

删除服务器

codex mcp remove demo-stdio
codex mcp remove demo-http

使用Gemini CLI进行测试

该项目包括 .gemini/settings.json （项目级配置），具有两个服务器配置

用法类似于Claude Code和Codex CLI。

HTTP传输比较

MCP配置比较

全局配置（克劳德代码）

要使MCP服务器可用于所有项目，请执行以下操作：

claude mcp add demo-stdio -- uv run python server_stdio.py

要删除：

claude mcp remove demo-stdio