Intro to Model Context Protocol在本地运行 Model Context Protocol
用这个页面运行提取的 TypeScript MCP 服务器，在 MCP Inspector 中试用其天气工具和资源。服务器通过标准输入和输出与客户端通信，因此它会等待客户端连接，而不是打开项目页面或应用端口。
你需要先准备什么
安装 Node 24。MCP Inspector 需要 Node 22.19 或更新版本，所以 Node 24 满足这个最低要求，而较旧的 LTS 版本可能无法启动测试界面。
这个项目不需要 API 密钥或 .env 文件。MCP 客户端以子进程的形式启动服务器，所以服务器运行的 Node 版本来自启动它的东西：你的终端、Inspector 或桌面客户端。
.env 文件。 有一点要注意：这个服务器从不打开网页。它会安静地等待客户端与它通信。
安装并修复服务器
在包含 package.json 的已提取服务器文件夹中打开终端：
$ cd path-to-your-downloaded-project
$ npm ci
$ npm install --save-dev tsx最后一个命令记录 tsx，这是运行 TypeScript 文件的工具，提取的 "start": "tsx server.ts" 脚本需要它。
你可以直接启动 stdio 服务器：
$ npm start它会等待 MCP 客户端，而不是打印浏览器 URL。启动 Inspector 前用 Ctrl+C 停止它。
npm ci，添加缺失的 tsx 工具来运行 TypeScript 文件，然后试试 npm start。 当终端安静下来时，说明没有问题：服务器在等待客户端。启动 Inspector 前用 Ctrl+C 停止它。
用 MCP Inspector 测试它
从同一个项目文件夹，运行官方 MCP Inspector：
$ npx @modelcontextprotocol/inspector npx tsx server.ts第一个 npx 下载并启动 Inspector。Inspector 然后用 npx tsx server.ts 作为 stdio 子进程启动你的服务器。Inspector 的 web UI 运行在自己的本地端口上，与到服务器的 stdio 连接分开。打开终端中打印的本地 URL，如果它没有自动打开的话。
主动批准一次性包下载
npx 可能会请求安装 MCP Inspector 的权限。接受前确认包名是 @modelcontextprotocol/inspector。为了可重复的团队使用，请固定一个经过审查的版本，而不是无限期地依赖最新版本。
在 Inspector 中，连接到服务器，列出它的工具和资源，并用课程中使用过的输入之一调用天气工具。工具使用章节解释了这样的工具定义能给模型带来什么。测试时保持终端打开，然后用 Ctrl+C 停止 Inspector 和子服务器。
如果 npx 要求安装包，检查名字是否是 @modelcontextprotocol/inspector 后再接受。
连接另一个 MCP 客户端
桌面客户端需要一个可执行命令和参数来启动同一个 stdio 服务器。首先，复制已提取项目文件夹和其 server.ts 文件的绝对路径。用这个流程契约配置客户端，替换两个示例路径：
command: npm
arguments:
- --prefix
- /absolute/path/to/project
- exec
- --
- tsx
- /absolute/path/to/project/server.ts--prefix 值让 npm 使用安装在该项目中的 tsx 依赖，即使桌面客户端从另一个工作目录启动也是如此。配置为独立运行 tsx 的客户端（前面没有 npm --prefix）反而依赖于全局安装和客户端的 PATH，这通常与你的终端不同。保持每个参数作为单独的项，以便包含空格的路径保持为一个值。不要添加 URL 或端口：这个服务器通过 stdio 通信。
客户端配置格式不同，所以将那个命令和参数映射到客户端当前 MCP 设置说明中的字段。修改配置后重启客户端。你不需要另一次项目下载：将它连接到你已经测试过的已提取服务器。代理章节讲述了当模型使用这样的工具时客户端运行的循环。
npm，添加上面的参数并填入两个绝对路径，然后重启客户端。 你在重用 Inspector 已经测试过的服务器，所以如果它在那里工作了，服务器端没有问题，任何问题都在客户端的设置中。
故障排除
tsx: command not found： 在项目文件夹中运行 npm install --save-dev tsx。对于桌面客户端，也要确认其命令是 npm，其参数以 --prefix 开头，后跟绝对项目路径。
Inspector 拒绝 Node 版本： 安装 Node 24，用 node --version 验证，然后重新打开终端。
npm start 看起来卡住了： 这对于等待客户端的 stdio 服务器是正常的。用 Inspector 与它交互。
Inspector 没有显示工具： 查看终端中的 TypeScript 或连接错误，确认最终命令以 npx tsx server.ts 结尾。
tsx 缺失就安装它，如果 Inspector 拒绝启动就升级到 Node 24，记住安静的服务器在等待，不是坏了。 这个页面上的大多数问题都是这三个之一。