第3章：环境搭建
🎯 章节目标：从一台干净电脑出发，搭好可运行、可调试的 MCP 开发环境 ⏱️ 章节时长：1–1.5 小时 📊 难度等级：⭐⭐ 基础（需会基本命令行操作）
🚀 章节概述
这一章是"动手"的起点。目标很明确：让后面每一章的代码都能在你机器上跑起来。
MCP 的生态横跨 Node.js（TypeScript、npm 包、Inspector 等工具链）和 Python（官方 SDK 主线之一）。所以本章两条腿都要配：Node.js 负责工具链与部分 SDK，Python 负责服务端开发的主力体验。
按顺序执行即可，每一步都有验证命令。尤其不要跳过最后的 3.5 环境验证——很多"后面跑不通"的问题，其实在这一步就能提前发现。
🗺️ 学习路径
📚 章节内容
| 小节 | 标题 | 核心内容 | 难度 |
|---|---|---|---|
| 3.1 | 系统要求 | 操作系统、硬件、Node.js / Python 版本要求 | ⭐ |
| 3.2 | 安装Node.js环境 | Node.js 安装、npm 配置、镜像加速、版本管理 | ⭐ |
| 3.3 | 配置Python环境 | Python 安装、虚拟环境、pip 依赖、MCP SDK 安装 | ⭐ |
| 3.4 | 开发工具配置 | VS Code 插件、MCP Inspector、Streamable HTTP 调试 | ⭐⭐ |
| 3.5 | 环境验证 | 逐项自检清单、常见报错与修复 | ⭐⭐ |
🖥️ 3.1 系统要求
先确认你的机器达标：操作系统、内存、磁盘、Node.js 与 Python 的版本区间。满足最低要求即可开始，推荐配置能获得更顺滑的调试体验。
看点：版本要求对照表、操作系统注意事项（Windows/macOS/Linux）。
🟩 3.2 安装Node.js环境
Node.js 是 MCP 工具链的基础：不少官方与社区 SDK、命令行工具、Inspector 都基于它。本节覆盖安装、npm 源配置与版本管理。
看点：多版本共存方案、国内镜像加速、node -v / npm -v 验证。
🐍 3.3 配置Python环境
Python 是 MCP 服务端开发的主力语言之一。本节讲清虚拟环境隔离、依赖安装，以及 MCP Python SDK 的正确装法。
看点：venv 隔离、pip install mcp 与版本确认、依赖清单管理。
💡 顺手提醒：SDK 的主线版本迭代很快，装完用
pip show mcp确认实际版本，后面章节的 API 写法以你本机版本为准。
🛠️ 3.4 开发工具配置
工欲善其事。VS Code 插件让代码有类型提示，MCP Inspector 让你可视化地连上服务器、逐个点开工具试参数。本节还会讲怎么调试 Streamable HTTP 传输。
看点：VS Code + Python/TypeScript 插件、Inspector 的启动与使用、Streamable HTTP 端点调试。
✅ 3.5 环境验证
把前面所有步骤做一次"体检"：版本查询、SDK 导入、示例服务器启动、Inspector 连通。全绿再进第4章。
看点：逐项检查命令、典型报错（路径、权限、镜像、版本冲突）与对应修复。
🎯 学习目标
读完本章，你应当能够：
- ✅ 确认自己的系统满足 MCP 开发要求
- ✅ 独立完成 Node.js 与 Python 两套环境的安装与配置
- ✅ 创建并激活 Python 虚拟环境，正确安装 MCP SDK
- ✅ 用 VS Code 与 MCP Inspector 搭好调试工作台
- ✅ 通过环境自检清单，排除版本、路径、网络等常见问题
🧰 环境自检速查
进入第4章前，逐条打勾：
node -v # 确认 Node.js 版本
npm -v # 确认 npm 可用
python --version # 确认 Python 版本
pip show mcp # 确认 MCP SDK 已安装及版本任何一条报错，回到 3.5 环境验证 对照修复，别带着问题往下走。
🚦 下一步
环境就绪，正式动手写第一个 MCP 服务器。