#安装与环境

本章装好 官方 Python SDK 与 MCP Inspector，并确认命令能跑。包名、导入路径以 python-sdk README 与 py.sdk.modelcontextprotocol.io 为准。

#环境要求

检查版本：

python --version
node --version
npm --version

Unix：

python3 --version
node --version
npm --version

#创建虚拟环境

PowerShell：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -U pip

若执行策略拦截脚本，可对当前用户放行（只需一次）：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Unix / macOS：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip

#安装官方 Python SDK

pip install mcp 现在安装的是 SDK v2（面向规范 2026-07-28）。带 CLI 额外依赖后，可以使用 mcp dev / mcp run：

pip install "mcp[cli]"

或使用 uv：

uv add "mcp[cli]"

Unix 相同。只要 SDK、不要 CLI 时：pip install mcp。

验证导入（v2 的类名是 MCPServer，不再是 v1 的 FastMCP）：

python -c "from mcp.server import MCPServer; print('ok', MCPServer)"

python -c 'from mcp.server import MCPServer; print("ok", MCPServer)'

旧教程里的 from mcp.server.fastmcp import FastMCP 会在 v2 上报 ModuleNotFoundError。装饰器风格没变（@mcp.tool() 等），只是类改名。必须停留在 v1 时再钉死 mcp>=1.28,<2，新项目请用 v2。社区另有独立的 FastMCP 项目，不是 本教程使用的官方包。

#安装 / 启动 Inspector

Inspector 包名是 @modelcontextprotocol/inspector，一般不必全局安装：

npx @modelcontextprotocol/inspector

npx @modelcontextprotocol/inspector

命令会打印带一次性会话 token 的 URL，用浏览器打开。三种入口：

装了 mcp[cli] 之后，还可以：

mcp dev .\server.py

mcp dev ./server.py

mcp dev 会拉起 Inspector 并用 stdio 连接你的文件。需要本机有 npx。

#建议目录

mcp-demo/
├── .venv/
├── server.py
├── notes/          # 实战案例用
├── requirements.txt
└── README.md

requirements.txt 最少一行：mcp[cli]。

#常见问题

python 不是命令（Windows）？
用 py -3.12 -m venv .venv，激活后再用 python。

Inspector 打不开 / 提示 Node 太旧？
对照 Inspector 文档 升级 Node；写 TS Server 仍可用 Node 18 的长期支持线，但调试器可能要求更新的运行时。

mcp 不是命令？
确认已 pip install "mcp[cli]" 且虚拟环境已激活；或用 python -m mcp。

想同时用多个 Python 项目？
每个教程目录单独 venv，避免与 LangChain 等课程抢依赖。

#下一步

• 快速上手
• Python 服务器
• 传输层