Introduction to MCP

基本能力

产品定位

introduction-to-mcp 是一个用于演示和开发调试的 MCP 服务器和客户端示例，支持 SSE 和 stdio 传输方式。

核心功能

• 支持基本的计算器操作（如加法、减法等）。
• 提供两种传输方式：SSE（Server-Sent Events）和 stdio（标准输入输出）。
• 支持开发模式下的热重载和调试工具（MCP Inspector）。

适用场景

• 开发者学习 MCP 协议的基本使用。
• 测试和调试 MCP 服务器和客户端的交互。
• 实时更新和通知的场景（使用 SSE 传输）。
• 本地开发和调试（使用 stdio 传输）。

工具列表

• server.py：MCP 服务器脚本，支持 FastMCP 服务器运行。
• client_stdio.py：使用 stdio 传输的客户端脚本，用于本地测试和调试。
• client_sse.py：使用 SSE 传输的客户端脚本，用于实时更新和通知。
• mcp 命令行工具：支持开发模式下的热重载和调试。

常见问题解答

• 问题：运行 mcp dev server.py 时服务器未监听指定端口（如 8050）。 解答：mcp dev 命令启动的是 MCP Inspector 和代理服务器（默认端口 6277），而非直接运行 FastMCP 服务器。如需在指定端口运行服务器，请使用 python server.py。
• 问题：如何选择传输方式？ 解答：使用 client_stdio.py 进行本地测试和调试，使用 client_sse.py 进行实时更新和通知。

使用教程

使用依赖

安装项目依赖：

pip install -r requirements.txt

安装教程

安装 mcp 包及其命令行工具：

pip install mcp[cli]

运行服务器

• 正常模式（监听指定端口，如 8050）：

python server.py

• 开发模式（支持热重载和调试）：

mcp dev server.py

运行客户端

• 使用 stdio 传输：

python client_stdio.py

• 使用 SSE 传输：

python client_sse.py

调试方式

• 使用 mcp dev server.py 启动开发模式，通过 MCP Inspector 进行调试。
• 客户端连接代理端口（默认 6277）以使用调试工具。

许可证

该项目遵循 None 开源许可条款。