Running Your MCP Server with FastMCP v2.0

使用 FastMCP v2.0 运行 MCP 服务

本指南将介绍如何使用 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("My Server", 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/[email protected]。