使用 FastMCP v2.0 运行您的 MCP 服务器并为 Claude Desktop 安装

本指南指导您如何使用 FastMCP v2.0 运行 MCP 服务器以及将其与 Claude Desktop 配合使用。

✅ 先决条件

假设：

• 您的环境已经设置好
• 您的服务器代码（例如 server.py）已完成且准备运行

🚀 运行服务器

1. 安装 FastMCP（如果尚未安装）

建议使用 uv：

uv pip install fastmcp

如果没有 uv，您可以通过 Homebrew（macOS）安装它：

brew install uv

或者直接使用 pip：

pip install fastmcp

2. 运行您的服务器

使用 FastMCP 的运行命令：

fastmcp run server.py

如果您的脚本使用标准入口点：

if __name__ == "__main__":
    mcp.run()

那么您也可以直接运行：

python server.py

🛠️ 为 Claude Desktop 安装服务器

1. 安装服务器

此命令准备您的服务器以便与 Claude Desktop 集成：

fastmcp install server.py

2. 重启 Claude Desktop

安装完成后，重启 Claude Desktop 以加载新安装的服务器。

🔧 其他提示

指定依赖项

声明额外的包以在实例化 FastMCP 时使用：

mcp = FastMCP("我的服务器", dependencies=["pandas", "numpy"])

设置环境变量

在安装期间传递环境变量：

fastmcp install server.py -e API_KEY=your_api_key

使用 .env 文件

从文件加载环境配置：

fastmcp install server.py -f .env

✅ 示例 Claude 提示

如果您定义了一个工具如 add，您可以这样与 Claude 交流：

"请将 5 和 7 相加。"

Claude 将使用 MCP 服务器计算结果。

更多详细信息，请访问：https://github.com/jlowin/fastmcp

ℹ️ 注意：如果您想使用调试工具如 mcp-inspector，应使用 @modelcontextprotocol/inspector@0.9.0 以获得最佳兼容性。