🚀 MCP 入门介绍

本项目提供了一个最小的 MCP 服务器和客户端示例，主要演示了借助 SSE（Server-Sent Events）和 stdio 传输实现的基本计算器操作，能帮助开发者快速了解 MCP 的使用。

🚀 快速开始

📦 安装指南

通过 pip 从 requirements.txt 文件安装所有包。可以在终端中运行以下命令：

pip install -r requirements.txt

🏃‍♂️ 运行服务器

首先，确保已经安装了 mcp 包。可以通过运行以下命令来实现：

pip install mcp[cli]

然后，可以使用以下命令运行 server.py 脚本：

mcp dev server.py

也可以直接使用 Python 运行 server.py：

python server.py

• 使用 python server.py 以正常模式运行。
• 使用 mcp dev server.py 进行开发，享受热重载和更好的开发体验。

⚠️ 重要提示

当您运行 mcp dev server.py 时，启动的是 MCP Inspector 及其代理服务器（默认端口 6277），而不是直接运行您在 server.py 中定义的 FastMCP 服务器。MCP Inspector 使用的端口是 6277，默认情况下不会使用 server.py 指定的 8050 端口。

如果希望您的 FastMCP 服务器监听 server.py 中定义的 8050 端口，应执行：python server.py

mcp dev 命令专为开发和调试 MCP Inspector 设计。如果您想连接到 Inspector，请使用代理端口（6277）。如果希望您的服务器侦听 8050 端口，则直接运行 python server.py。

💻 运行客户端

STDIO 客户端

将服务器作为子进程启动，并通过 stdio 传输连接到它。这对于测试和调试很有用。

python client_stdio.py

SSE 客户端

通过 sse 传输连接到服务器。这适用于实时更新和通知。

python client_sse.py

🔗 链接

• 服务器开发快速入门
• 客户端开发快速入门