大家好，我是晚安code。

上个月我想让 AI 帮我查快递。却折腾半天才发现它不是不会，而是「手」和「眼睛」都得靠外部工具接。搜索时总能看到 MCP、协议、传输等词，直接把我劝退。后来照官方仓库一步步走，才发现 MCP Server 开发其实并没有想象中的玄：一条命令建工程。一个类暴露工具，几分钟就能跑通。这篇文章拆解整个流程，并附上三种传输协议的选型避坑。让你看完后能写出自己的第一个服务器。

AI 的 USB‑C 接口

MCP是 Anthropic 开源的大模型上下文协议，让大模型通过统一接口调用外部工具和数据源。你可以把它想象成「AI 的 USB‑C 接口」——一根线，接遍所有设备。说起来，

真正干活的是MCP Server本质就是一段 Node.js 或 Python 程序。把外部工具包装成 MCP 认识的接口，再交给 AI 客户端调用。把它当成「给 AI 打工的工具接线员」。

如果不加一层 MCP Server，AI 直接连数据库或调用接口会带来安全风险：权限、白名单、操作边界全都失控。通过 Server，你可以把这些边界牢牢握在自己手里。

二、动手前准备：用 uv 建一个 Python 工程

MCP Server 并不要求你懂底层协议；Python 官方 SDK 已将最难部分封装好，只需先搭好环境即可。

uv 简介

• uv 是 Python 环境里最快的包管理与虚拟环境工具。一条命令建工程、装依赖、切换 Python 版本，一切更快、更便捷。
• 其功能可视作「更快的 pip + venv」。

安装与初始化

powershell -ExecutionPolicy ByPass -c "&{ irm https://astral.sh/uv/install.ps1 | iex }"
uv init . -p
uv add "mcp"

• #1：在 Windows 上安装 uv。
• #2：`uv init . -p` 将当前空文件夹初始化为 Python 项目。怎么说呢，
• #3：`uv add "mcp"` 安装官方 MCP SDK。并包含 cli 以便使用 MCP Inspector 调试工具。
• 提示：完成后请先激活虚拟环境。再运行代码，否则会找不到依赖。

P.S. 常见坑与方法

MCP SDK 版本差异导致导入错误：

• If you see “import from mcp.server import MCPServer” error,you’re probably mixing SDK v2 with stable vX version.
• The stable SDK exposes `from mcp.server.fastmcp import FastMCP`.
• No need to worry—just stick with stable release and use FastMCP.

三、写一个能跑通的 MCP Server：tool 与 resource 两大主要概念

@mcp.tool vs @mcp.resource

触发方式 大模型按需调用 说到示例。add,send_email
通过 URI 模板请求 说到示例，greeting://{name} 典型用途 执行任务，例如发邮件、查询订单等 返回信息，例如天气预报、配置项等 示例代码片段 @mcp.tool def add->int:return a+b @mcp.resource def greeting->str:return f"Hello,{name}!" "如何验证？" 一行命令打开 MPC Inspector，可视化面板左侧显示已注册工具右侧直接调试！ 再看"常见坑。" 必须正确写 name == "main"，否则程序不运行！type hint & docstring 一样不可缺失。说起来，t d> "Tip：" 若想快速验证。请先用 python server.py；不过，若要打开 Inspector。请运行 mcp dev server.py。tr> "小技巧：" 在 VSCode 中安装 Python 与 Debugger 插件。并激活 .venv 虚拟环境，可享受断点调试体验！按理说，tr> "注意：" 如果你使用旧教程中的 from mcp.server import MCPServer 导入错误。请检查是否混用了旧版 SDK；话说回来，新版请使用 from mcp.server.fastmcp import FastMCP。tr>

"" 使用 FastMCP 更稳定且易于维护。tr>

"一句话：" 用 @mcp.tool 暴露可执行操作，用 @mcp.resource 暴露只读资料；两者配合就可以完整交互，tr>

"代码文件名建议写成 server.py，以便日后 和维护。" tr>

python

from mcp.server.fastmcp import FastMCP

app = FastMCP

@app.tool def add -> int: """Add two numbers.""" return a + b

@app.resource def greeting -> str: """Greet someone by name.""" return f"Hello,{name}!"

if name == "main": # 默认走 stdio 传输方式。可根据需要改为 streamable-http 等 app.run