第四章：准备工作与客户端选择

一、先选客户端：这是 MCP 旅程的"第一道分叉口"

要用 MCP，你需要一个支持 MCP 的"AI 客户端"（也就是上一章说的 Host）。 2026 年 4 月，原生支持 MCP 的主流客户端有：

一张"决策表"帮你选

本书后续例子的默认客户端 = Claude Desktop。

原因：

1. MCP 是 Anthropic 提出的，Claude Desktop 是参考实现，文档最齐、坑最少；
2. 跨 Mac / Windows，免费版就能配 MCP；
3. 配置方式（JSON）几乎是行业事实标准，学会一种通吃。

第七章会专门讲 Cursor / VS Code / ChatGPT 的差异。

二、检查电脑环境：5 分钟自检

不管你选哪个客户端，下面这些是 MCP 服务器最常依赖的"地基"。 我们一次性把它装好，省得后面边装边修。

1. 确认你有"管理员权限"或"sudo 权限"

• Mac：登录的账号必须是"管理员"。
• Windows：能用"以管理员身份运行"启动程序。
• Linux：能 sudo。

如果是公司电脑装不了软件，先去找 IT 授权—— 否则后面 90% 的 MCP 服务器你都装不上。

2. 检查 Node.js（必装，最常用）

打开终端（Mac：「终端」App；Windows：「PowerShell」或「Windows Terminal」），输入：

node -v

• 如果显示 v20.x.x 或更高版本：已装好。
• 如果显示"command not found"：需要装。

安装 Node.js（推荐 LTS 版本）

统一推荐方式：去官网 nodejs.org 下载 LTS 版（截至 2026 年 4 月，LTS 是 22.x）。

• Mac：下载 .pkg 安装包，一路下一步。
• Windows：下载 .msi 安装包，一路下一步，勾选"Add to PATH"。
• Linux：

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

装完再运行 node -v 验证。

进阶用户可以用 nvm（Mac/Linux）或 nvm-windows（Windows）管理多版本， 但新手就用官网安装包，不要折腾。

3. 检查 Python（部分 MCP 服务器需要）

python3 --version

• 显示 Python 3.10.x 或更高：够用。
• 没装或版本太低：去 python.org 下载安装。

推荐顺手装 uv（更快的 Python 包管理器）

很多新版 MCP 服务器（包括 Anthropic 官方推荐的写法）都用 uv 跑。

• Mac：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

装完后运行 uv --version 看是否成功。

4. 检查 Git（强烈建议装）

git --version

没装就去 git-scm.com 下载。 配置一下你的名字和邮箱：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

5.（可选）装一个好用的"代码编辑器"

哪怕你完全不写代码，也强烈建议装 VS Code（code.visualstudio.com）。 原因：

• 编辑 MCP 配置文件（JSON）时，它能高亮、自动格式化、报错提示；
• 后面写自定义 MCP 的时候，它就是你的工作台；
• 装一个免费插件「JSON Tools」就能让你看 JSON 不眼瞎。

三、安装 Claude Desktop（本书默认客户端）

Mac

1. 打开 claude.ai/download 下载 Mac 版；
2. 双击 .dmg，把 Claude.app 拖进 Applications；
3. 启动 Claude.app，登录你的 Anthropic 账号；
4. 在右上角设置里找到「General」→「Theme」自己选个喜欢的主题。

Windows

1. 同样地址下载 Windows 版（.exe 安装包）；
2. 双击安装，注意勾选"为所有用户安装"或自己用户，按需选；
3. 装完登录账号。

Linux

Claude Desktop 官方目前仍未原生支持 Linux（截至 2026 年 4 月）。 Linux 用户可以用：

• Claude.ai 网页版 + Cherry Studio / LobeChat（开源客户端，支持 MCP）；
• 或用 Cursor（Linux 原生支持）。

四、提前规避的 5 个新手大坑

坑 1：Node 版本太低

很多 MCP 服务器要求 Node ≥ 18，最稳妥是直接装当前 LTS（22.x）。 如果你电脑上多年前装过 Node 14/16，请升级。

坑 2：路径里有中文 / 空格

Mac/Windows 上有时桌面路径会带中文或空格，比如：

/Users/张三/Desktop
C:\Users\Zhang San\Documents

部分 MCP 服务器对此处理不好，建议为 MCP 专门建一个英文路径文件夹：

~/mcp-data
C:\mcp-data

把所有要让 AI 操作的文件放进去，省心 99%。

坑 3：用 sudo / 管理员权限装 npm 包

不要用 sudo npm install -g xxx！ 正确方式是用 npx -y xxx 一次性运行（这也是绝大多数 MCP 服务器的标准用法）。

坑 4：公司电脑代理 / 防火墙

公司网络常常拦 npm registry 或 GitHub。 如果命令一直卡在 npm install，先确认能不能访问：

npm config get registry
# 如果在国内访问慢，可以临时换源（仅个人电脑用）
npm config set registry https://registry.npmmirror.com

公司电脑出问题就找 IT 帮忙加白名单，不要随便改 npm 全局配置。

坑 5：Claude Desktop 的"配置文件"找不到

最常见的问题是：第一次打开 Claude Desktop，没有 claude_desktop_config.json 文件。 解决办法：在 Claude Desktop 的 设置 → 开发者 → 编辑配置， 点一下，它会自动帮你创建空文件。这点会在第五章手把手讲。

五、为 MCP 准备一个"沙盒文件夹"

强烈建议你在桌面或者 home 目录下， 建一个专门给 AI 操作的文件夹：

• Mac：~/mcp-sandbox
• Windows：C:\mcp-sandbox

这个文件夹的作用：

1. 限定 AI 的操作范围——后面配置 filesystem MCP 时，只让它访问这个文件夹；
2. 快速试错——出错了大不了删掉重建；
3. 整洁——你的真正重要文件不会被 AI 误碰。

可以在里面预放几样测试用文件：

mcp-sandbox/
├── todo.txt          # 一个待办清单
├── notes/            # 一个空文件夹，等 AI 帮你建笔记
├── photos/           # 放几张图片用于"分类"测试
└── data.csv          # 一份小型 CSV 数据

六、本章小结

1. 选一个支持 MCP 的客户端，新手建议 Claude Desktop；
2. 装好 Node.js（LTS）、Python（≥3.10）、Git；
3. 顺手装 uv 和 VS Code；
4. 准备一个英文路径的 mcp-sandbox 文件夹给 AI 玩；
5. 规避中文路径、Node 版本低、公司代理、sudo npm 这 4 个最常见坑。

七、动手任务（15 分钟）

完成下面这张"上手清单"，全部打勾你就具备了下一章的入场券：

• 我已经选定了客户端：____________
• node -v 输出版本 ≥ 18
• python3 --version 输出版本 ≥ 3.10
• git --version 正常输出
• 已下载并登录 Claude Desktop（Linux 用户：选定一个支持 MCP 的客户端）
• 已经在桌面或 home 目录下建好 mcp-sandbox 文件夹

打完勾，我们去第五章——装上你的第一个 MCP。