My FastMCP Example

🚀 使用 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 以获得最佳兼容性。