前提条件

ℹ️ 注意：此设置仅在 macOS 上进行了测试。

使用 这些说明 安装 Homebrew。

Python

任何版本等于或高于 Python 3.10 的都应该可以工作。安装如下所示：

brew install python

同时安装 Python 包管理器 uv，按照官方说明进行。

npx

我们还需要 npx。我们可以使用 Node 包管理器 npm 来获得它。

使用 这些说明 安装 Node.js 版本管理器 nvm。

然后安装 Node.js 和 npm。我们选择版本 22 "Jod"（LTS）。

nvm install lts/jod

这将同时为您提供 Node.js、npm 和 npx。您可以通过运行以下命令验证 npx 的安装：

npx --version

安装依赖项

在项目目录的根目录中，运行以下命令：

uv sync

运行和测试服务器

MCP SDK 是项目依赖的一部分，因此我们可以使用 MCP Inspector 工具。

在项目目录根目录中，运行：

uv run mcp dev server.py

它将输出一条消息，例如：

MCP  Inspector 正在 http://127.0.0.1:{somePort} 上运行并准备就绪

继续点击该链接在浏览器中打开，以查看 MCP Inspector。

对于 传输类型，选择 STDIO。点击 连接，如果成功，您将看到 inspector 视图填充内容。