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 以獲得最佳兼容性。