Python Alfresco MCP Server

🚀 Python Alfresco MCP Server v1.1

Python Alfresco MCP Server v1.1是一款用於Alfresco內容服務的模型上下文協議（MCP）服務器，具備豐富的工具和功能，可用於搜索和內容管理。它提供了完整的文檔、示例以及針對各種MCP客戶端的配置，能幫助用戶高效地進行內容管理和搜索操作。

🚀 快速開始

安裝Python

你需要安裝Python 3.10+，若未安裝，可從Python.org Downloads下載最新的3.13.x版本。

UV/UVX設置（推薦）

UV 是用 Rust 編寫的現代Python包管理器，提供 uv（包管理器）和 uvx（工具運行器）。由於其編譯性質和優化的依賴解析，它比 pip 快得多。

# 安裝UV（提供uv和uvx命令）
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux  
curl -LsSf https://astral.sh/uv/install.sh | sh

# 或者通過pip安裝
pip install uv

# 驗證安裝（兩個命令都應正常工作）
uv --version
uvx --version

UV參考鏈接：

• UV安裝指南 - 官方安裝說明和特定平臺選項
• UV文檔 - 完整的UV文檔、指南和高級用法

安裝方式選擇

選項A：UVX - 現代工具運行器（推薦給用戶）

UVX 是UV的工具運行器，類似於 pipx，但更快、更現代。它會自動處理隔離和全局可用性：

# 使用uvx安裝python-alfresco-mcp-server（在完成上述UV/UVX設置後）
uvx python-alfresco-mcp-server --help

# 這將測試安裝是否成功 - UVX會在首次使用時自動安裝包！

為什麼選擇UVX：UVX結合了 pipx（隔離環境 + 全局可用性）的優點，以及UV基於Rust的速度和現代依賴解析能力。它會在首次使用時自動安裝包。

選項B：UV - 現代包管理器（推薦用於開發）

UV 是用 Rust 編寫的現代Python包管理器，能自動處理一切。由於其編譯性質和優化的依賴解析，它比 pip 快得多。

# 從PyPI安裝並運行（對用戶來說最快）
uv tool install python-alfresco-mcp-server
uv tool run python-alfresco-mcp-server --help  # 測試安裝是否成功

# 或者從源代碼安裝（用於開發）
git clone https://github.com/stevereiner/python-alfresco-mcp-server.git
cd python-alfresco-mcp-server
uv run python-alfresco-mcp-server --help  # 測試安裝是否成功

選項C：傳統方法（pip和pipx）

有關傳統Python包管理方法，請參閱 使用pip和pipx安裝。

注意：你仍然需要使用適當的配置來配置你的MCP客戶端（Claude Desktop、MCP Inspector等）。有關客戶端配置詳細信息，請參閱下面的 MCP客戶端設置和使用 部分。

源代碼安裝（用於開發）

若要進行開發或訪問最新功能：

# 1. 克隆倉庫
git clone https://github.com/stevereiner/python-alfresco-mcp-server.git
cd python-alfresco-mcp-server

# 2. UV會自動處理一切 - 立即運行！
uv run python-alfresco-mcp-server --help  # 測試安裝是否成功

# 或者為開發顯式安裝依賴項
uv sync                    # 基本依賴項
uv sync --extra dev        # 包含開發工具  
uv sync --extra test       # 包含測試工具
uv sync --extra all        # 包含所有內容

配置Alfresco連接

選項1：環境變量

# Linux/Mac
export ALFRESCO_URL="http://localhost:8080"
export ALFRESCO_USERNAME="admin"
export ALFRESCO_PASSWORD="admin"
export ALFRESCO_VERIFY_SSL="false"

# Windows PowerShell
$env:ALFRESCO_URL="http://localhost:8080"
$env:ALFRESCO_USERNAME="admin"
$env:ALFRESCO_PASSWORD="admin"
$env:ALFRESCO_VERIFY_SSL="false"

# Windows Command Prompt
set ALFRESCO_URL=http://localhost:8080
set ALFRESCO_USERNAME=admin
set ALFRESCO_PASSWORD=admin
set ALFRESCO_VERIFY_SSL=false

選項2：.env文件（推薦 - 跨平臺）

# 複製sample-dot-env.txt到.env並進行自定義
# Linux/macOS
cp sample-dot-env.txt .env

# Windows
copy sample-dot-env.txt .env

# 編輯.env文件並設置你的配置
ALFRESCO_URL=http://localhost:8080
ALFRESCO_USERNAME=admin
ALFRESCO_PASSWORD=admin
ALFRESCO_VERIFY_SSL=false

注意：出於安全考慮，.env 文件不會被提交到git。請使用 sample-dot-env.txt 作為模板。

📖 有關完整的設置選項，請參閱 配置指南

Alfresco安裝

如果你還沒有安裝Alfresco服務器，可以從Github獲取社區版的Docker鏡像：

git clone https://github.com/Alfresco/acs-deployment.git

切換到Docker Compose目錄

cd acs-deployment/docker-compose

編輯community-compose.yaml

• 注意：你可能需要註釋掉除8161之外的activemq端口

   ports:
   - "8161:8161" # Web控制檯
   #- "5672:5672" # AMQP
   #- "61616:61616" # OpenWire
   #- "61613:61613" # STOMP

使用Docker Compose啟動Alfresco

docker-compose -f community-compose.yaml up

MCP服務器啟動

使用UVX（推薦 - 自動隔離和全局可用）

# 使用STDIO傳輸運行MCP服務器（默認）
uvx python-alfresco-mcp-server

# 使用HTTP傳輸進行Web服務（與MCP Inspector匹配）
uvx python-alfresco-mcp-server --transport http --host 127.0.0.1 --port 8003

# 使用SSE傳輸進行即時流
uvx python-alfresco-mcp-server --transport sse --host 127.0.0.1 --port 8001

使用UV（用於開發或源代碼安裝）

# 使用STDIO傳輸運行MCP服務器（默認）
uv run python-alfresco-mcp-server

# 使用HTTP傳輸進行Web服務（與MCP Inspector匹配）
uv run python-alfresco-mcp-server --transport http --host 127.0.0.1 --port 8003

# 使用SSE傳輸進行即時流
uv run python-alfresco-mcp-server --transport sse --host 127.0.0.1 --port 8001

使用傳統方法（pip/pipx） 有關 pip 和 pipx 的使用說明，請參閱 使用pip和pipx安裝。

MCP客戶端設置和使用

Python-Alfresco-MCP-Server已在Claude Desktop上進行了測試，推薦將其作為最終用戶的MCP客戶端。同時，它也在MCP Inspector上進行了測試，推薦開發人員使用該工具來測試帶有參數值的工具。

🤖 Claude Desktop（適用於Windows（已測試）和MacOS（未測試））

📖 完整設置指南：Claude Desktop設置指南

📥 下載Claude Desktop（免費版和專業版）

• 下載Claude Desktop - 官方Anthropic下載頁面
• 僅適用於 Windows 和 macOS（無Linux版本）
• 免費層 包括完整的MCP支持和Claude Sonnet 4訪問權限，但有一定限制，較舊的Claude模型（Claude Opus 4僅在專業版中可用）

🔧 根據安裝方法進行Claude Desktop配置 Claude Desktop的配置因MCP服務器的安裝方式而異：

1. UVX（推薦 - 現代工具運行器）

{
  "command": "uvx",
  "args": ["python-alfresco-mcp-server", "--transport", "stdio"]
}

• 示例配置文件：
  • Windows:
  • macOS:
• UVX會自動處理隔離和全局可用性
• 最快、最現代的方法

2. UV（開發或源代碼安裝）

{
  "command": "uv",
  "args": ["run", "python-alfresco-mcp-server", "--transport", "stdio"],
  "cwd": "C:\\path\\to\\python-alfresco-mcp-server"
}

• 示例配置文件：
  • Windows:
  • macOS:
• 使用 uv run 並將 cwd 指向你的 項目目錄
• UV會自動找到並使用項目目錄中的 .venv
• 適用於源代碼安裝和 uv tool install 之後

3. 傳統方法（pipx/pip） 有關傳統安裝方法，請參閱 使用pip和pipx安裝，其中涵蓋：

• pipx： /
• pip：手動配置虛擬環境路徑

🔐 逐個工具的權限系統 Claude Desktop會在首次使用每個工具時單獨提示你。由於此MCP服務器有15個工具，如果你使用所有功能，可能會看到多達15個權限提示。對於每個工具，你可以選擇：

• "僅允許一次" - 僅批准本次使用該工具
• "始終允許" - 自動批准該特定工具的所有未來使用（推薦用於常規使用）

此逐個工具的安全功能可確保你對可執行的外部工具保持精細控制。

🛡️ 病毒掃描器注意事項：如果你使用Norton 360等病毒檢查器，當你第一次看到pip、pipx、uv、uvx或python-alfresco-mcp-server.exe的 "檢查中" 消息時，不要擔心 - 這是正常的安全掃描行為。

使用工具：

• 自然聊天 表達你對文檔和搜索的需求
• 提及 "Alfresco" 以確保使用MCP服務器（例如，"在Alfresco中..."）
• 使用與工具相關的關鍵詞 - 提及與工具名稱相近的內容
• 後續提示 會基於之前的上下文了解文檔信息

示例1：文檔管理

1. 上傳一個簡單的文本文檔："請在存儲庫共享文件夾中創建一個名為 'claude_test_doc-25 07 25 101 0 AM.txt' 的文件，內容為：'This is a test document created by Claude via MCP.'，描述為 'Test document uploaded via Claude MCP'"
2. 更新屬性："將此文檔的描述屬性設置為 'my desc'"
3. 檢出文檔
4. 取消檢出
5. 再次檢出
6. 作為主要版本檢入
7. 下載文檔
8. 從 "C:\1 sample files\cmispress.pdf" 上傳第二個文檔

注意：Claude會在第二次嘗試時自動使用base64編碼進行首次上傳

示例2：搜索操作 "使用Alfresco，請測試所有3種搜索方法和CMIS查詢"：

• 基本搜索 "txt" 文檔，最多返回10個結果
• 高級搜索2024-01-01之後創建的文檔，最多返回25個結果
• 元數據搜索cm:title包含 "test" 的文檔，限制為50個結果
• CMIS搜索查找所有txt文檔，限制為50個結果

更多示例：創建文件夾、瀏覽文件夾、獲取存儲庫信息

• "在共享文件夾中創建一個名為 '25 07 25 01 18 am' 的文件夾"
• "列出共享文件夾中的文檔和文件夾" （將使用 -shared-）
• "你能告訴我我的Alfresco主目錄中有什麼嗎？" （將使用browse_repository -my-）
• "獲取Alfresco的信息" （將使用repository_info工具）

聊天框按鈕：

• 使用聊天框中的 搜索和工具按鈕（兩條水平線和圓形圖標），選擇 "python-alfresco-mcp-server" - 這允許你啟用/禁用所有工具或單個工具
• 點擊 + 按鈕 → "從Alfresco添加" 以快速訪問資源和提示

搜索和分析提示：

• 提供一個帶有查詢字段的表單，用於全文搜索
• 分析類型：摘要、詳細、趨勢 或 合規性
• 生成可複製的模板文本，以便複製到聊天中進行編輯

存儲庫信息資源（和工具）：

• 以文本格式提供存儲庫狀態信息，以便查看或複製

示例：

• 有關測試工具的示例，請參閱

🔍 MCP Inspector（開發/測試）

📖 設置指南：完整的MCP Inspector設置和連接說明請參閱 MCP Inspector設置指南

📥 安裝MCP Inspector：

• 先決條件：需要 Node.js 18+ - 從 nodejs.org 下載
• 安裝命令：npm install -g @modelcontextprotocol/inspector
• 或者直接運行：npx @modelcontextprotocol/inspector（無需全局安裝）
• 用途：基於Web的工具，用於使用自定義參數測試MCP服務器和單個工具

推薦的工作方法： 1. 使用HTTP傳輸啟動MCP服務器

# 使用UVX（推薦）
uvx python-alfresco-mcp-server --transport http --port 8003

# 使用UV（開發）
uv run python-alfresco-mcp-server --transport http --port 8003

# 傳統方法 - 請參閱傳統安裝指南

2. 使用配置啟動MCP Inspector UVX安裝（推薦）

# 使用stdio傳輸啟動
npx @modelcontextprotocol/inspector --config mcp-inspector-stdio-uvx-config.json --server python-alfresco-mcp-server

# 使用http傳輸啟動
npx @modelcontextprotocol/inspector --config mcp-inspector-http-uvx-config.json --server python-alfresco-mcp-server

UV安裝（開發）

# 從存在配置文件的項目目錄中啟動
npx @modelcontextprotocol/inspector --config mcp-inspector-stdio-uv-config.json --server python-alfresco-mcp-server  # stdio傳輸
npx @modelcontextprotocol/inspector --config mcp-inspector-http-uv-config.json --server python-alfresco-mcp-server   # http傳輸

傳統方法（pipx/pip） 有關pipx和pip的配置選項，請參閱 使用pip和pipx安裝。

3. 使用預填充的令牌打開瀏覽器

• 使用輸出中提供的URL（包含身份驗證令牌）
• 示例：http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=<token>
• 此步驟適用於 所有安裝方法（uv、uvx、pip、pipx）

這種方法可以避免代理連接錯誤，並提供直接身份驗證。

🔧 其他MCP客戶端

對於Cursor、Claude Code和其他MCP客戶端： 📖 完整設置指南：客戶端配置指南

✨ 主要特性

內容管理和搜索工具

• 搜索工具：
  • 全文搜索：支持通配符的基本內容搜索 (search_content)
  • 高級搜索：使用AFTS查詢語言，支持日期過濾、排序和字段定位
  • 元數據搜索：基於屬性的查詢，支持多種比較運算符
  • CMIS搜索：類似SQL的查詢，用於複雜的內容發現
• 文檔生命週期管理：上傳、下載、簽入、簽出、取消簽出
• 版本管理：創建主要/次要版本並添加註釋
• 文件夾操作：創建文件夾、刪除文件夾節點
• 屬性管理：獲取和設置文檔/文件夾的屬性和名稱
• 節點操作：刪除節點（文檔和文件夾）（放入回收站或永久刪除）
• 存儲庫信息：（工具和資源）返回存儲庫狀態、版本、是否為社區版或企業版以及模塊配置

MCP架構

• FastMCP 2.0框架：現代、高性能的MCP服務器實現
• 多種傳輸方式：
  • STDIO（直接MCP協議） - 默認且最快
  • HTTP（RESTful API） - 用於Web服務和測試
  • SSE（服務器發送事件） - 即時流更新
• 企業級安全：OAuth 2.1（可選）
• 類型安全：完整的Pydantic v2模型
• 內存內測試：更快的客戶端測試執行
• 配置：支持環境變量、.env文件

Alfresco集成

可與Alfresco社區版（已測試）和企業版配合使用

📦 安裝指南

請參考上述快速開始部分的安裝步驟，包括Python安裝、UV/UVX設置、不同安裝方式的選擇以及Alfresco連接配置等內容。

💻 使用示例

基礎用法

以下是使用UVX啟動MCP服務器的基本示例：

uvx python-alfresco-mcp-server

高級用法

以下是使用HTTP傳輸啟動MCP服務器的示例，適用於Web服務和測試：

uvx python-alfresco-mcp-server --transport http --host 127.0.0.1 --port 8003

📚 詳細文檔

文檔與示例

• 📚 完整文檔：包含10篇指南，涵蓋從設置到部署的各個方面
• 💡 示例：提供6個實際示例，從快速入門到實現模式
• 🔧 配置管理：支持環境變量、.env文件和命令行配置
• 🏗️ 與MCP客戶端配合使用的設置說明

學習資源

• 🚀 快速入門指南：5分鐘完成設置並進行首次操作
• 🤖 Claude Desktop設置：為用戶和開發人員提供完整的Claude Desktop配置說明
• 🔧 客戶端配置：為Cursor、Claude Code和其他MCP客戶端提供設置指南
• 📖 示例庫：包含實現模式和示例

涵蓋設置、部署和使用的指南

• 📚 文檔中心 - 完整的導航和概述
• 🚀 快速入門指南 - 5分鐘完成設置並進行首次操作
• 📦 使用pip和pipx安裝 - 傳統的Python包安裝方法
• 🤖 Claude Desktop設置 - 為用戶和開發人員提供完整的Claude Desktop配置說明
• 🔧 客戶端配置 - 為Cursor、Claude Code和其他MCP客戶端提供設置指南
• 🔍 MCP Inspector設置 - 使用MCP Inspector進行開發和測試
• 🔍 API參考 - 完整的工具和資源文檔
• ⚙️ 配置指南 - 從開發到部署的配置說明
• 🧪 測試指南 - 質量保證和測試開發
• 🛠️ 故障排除指南 - 問題診斷和解決

🔧 技術細節

v1.1版本的新特性

模塊化架構與增強測試

• FastMCP：v1.0版本的FastMCP 2.0實現將所有工具的實現都放在 fastmcp_server.py 文件中
• v1.1版本的代碼模塊化：將單文件的整體結構拆分為有組織的模塊化結構，使用單獨的文件
• 目錄組織：分為 tools/search/、tools/core/、resources/、prompts/、utils/ 目錄
• 增強測試：完整的測試套件轉換 - 143個測試，通過率100%
• 客戶端配置文件：添加了專門的Claude Desktop和MCP Inspector配置文件
• 即時集成測試：21個Alfresco服務器驗證測試，確保真實世界的功能正常
• Python-Alfresco-API：python-alfresco-mcp-server v1.1 需要v1.1.1版本的python-alfresco-api包

測試套件概述

• 共143個測試：100%通過 - 覆蓋所有功能
• 122個單元測試：100%通過 - 使用模擬驗證核心功能（FastMCP 2.0、工具、覆蓋率）
• 21個集成測試：100%通過 - 即時服務器測試（搜索、上傳、下載、文檔生命週期）
• 集成測試：自動化的端到端測試，覆蓋所有核心文檔生命週期場景
• 性能驗證：搜索時間 <1秒，支持併發操作和資源訪問

覆蓋率報告（清理後）

• 總體覆蓋率：51%（測試了1,829條語句）
• FastMCP 2.0核心：經過充分測試，具有全面的單元覆蓋率
• 配置模塊：93%覆蓋率 - 完全測試
• 包初始化：100%覆蓋率（5/5行） - 完整
• 整個項目：對全面的代碼庫實現了51%的覆蓋率

運行測試

# 運行完整的測試套件
pytest

# 運行並生成覆蓋率報告
pytest --cov=alfresco_mcp_server --cov-report=term-missing

# 運行特定類型的測試
pytest -m "unit"           # 僅運行單元測試
pytest -m "fastmcp"        # 運行FastMCP 2.0測試
pytest -m "integration"    # 運行集成測試（需要Alfresco）

🧪 有關詳細的測試策略，請參閱 測試指南

測試類別和執行

項目包括 4個級別的測試：

1. 📋 單元測試（122個測試） - 快速、模擬、隔離的組件測試
2. 🔗 集成測試（21個測試） - 即時Alfresco服務器測試
3. 📝 綜合測試 - 自動化的核心文檔生命週期場景測試
4. 📊 覆蓋率測試 - 覆蓋邊緣情況和錯誤路徑

🛠️ 可用工具（共15個）

🔍 搜索工具（4個）

工具	描述	參數
search_content	搜索文檔和文件夾	query (str), max_results (int), node_type (str)
advanced_search	帶過濾器的高級搜索	query (str), content_type (str), created_after (str) 等
search_by_metadata	按元數據屬性搜索	property_name (str), property_value (str), comparison (str)
cmis_search	CMIS SQL查詢	cmis_query (str), preset (str), max_results (int)

🛠️ 核心工具（11個）

工具	描述	參數
browse_repository	瀏覽存儲庫文件夾	node_id (str)
repository_info	獲取存儲庫信息	無
upload_document	上傳新文檔	filename (str), content_base64 (str), parent_id (str), description (str)
download_document	下載文檔內容	node_id (str), save_to_disk (bool)
create_folder	創建新文件夾	folder_name (str), parent_id (str), description (str)
get_node_properties	獲取節點元數據	node_id (str)
update_node_properties	更新節點元數據	node_id (str), name (str), title (str), description (str), author (str)
delete_node	刪除文檔/文件夾	node_id (str), permanent (bool)
checkout_document	簽出文檔進行編輯	node_id (str), download_for_editing (bool)
checkin_document	編輯後簽入文檔	node_id (str), comment (str), major_version (bool), file_path (str)
cancel_checkout	取消簽出/解鎖	node_id (str)

📖 有關詳細的工具文檔，請參閱 API參考

📊 可用資源

存儲庫信息

資源	描述	訪問方法
repository_info	獲取全面的存儲庫信息，包括版本、版本類型、許可證詳細信息、安裝的模塊和系統狀態	既可用作MCP資源，也可用作工具

repository_info 資源提供：

• 存儲庫詳細信息：ID、版本類型（社區版/企業版）、版本信息
• 許可證信息：頒發/過期日期、剩餘天數、許可證持有者、權限
• 系統狀態：只讀模式、審計啟用、快速共享、縮略圖生成
• 安裝的模塊：最多10個模塊的ID、標題、版本和安裝狀態

📖 有關詳細的資源文檔，請參閱 API參考

🎯 可用提示

搜索和分析提示

提示	描述	參數
search_and_analyze	交互式表單，用於引導式內容搜索和分析	query (搜索詞), analysis_type (摘要/詳細/趨勢/合規性)

搜索和分析提示提供：

• 交互式表單：用戶友好的界面，帶有查詢輸入字段
• 分析選項：可選擇摘要、詳細分析、趨勢或合規性報告
• 模板生成：創建可複製的模板文本，用於聊天對話
• 查詢輔助：幫助用戶構建有效的搜索查詢
• 多種搜索類型：集成了所有4種搜索工具（內容、高級、元數據、CMIS）

📖 有關詳細的提示文檔，請參閱 API參考

🔧 配置選項

環境變量	默認值	描述
ALFRESCO_URL	http://localhost:8080	Alfresco服務器URL
ALFRESCO_USERNAME	admin	用於身份驗證的用戶名
ALFRESCO_PASSWORD	admin	用於身份驗證的密碼
ALFRESCO_VERIFY_SSL	false	驗證SSL證書
ALFRESCO_TIMEOUT	30	請求超時時間（秒）
FASTAPI_HOST	localhost	FastAPI主機
FASTAPI_PORT	8000	FastAPI端口
LOG_LEVEL	INFO	日誌級別
MAX_FILE_SIZE	100000000	最大上傳大小（字節）

⚙️ 有關部署選項，請參閱 配置指南

🏗️ 架構

┌─────────────────────────────────────────────────────┐
│                   MCP Clients                       │
│  Claude Desktop │ MCP Inspector │ Cursor │ Claude   │
│     Code │ n8n │ LangFlow │ Custom MCP Client App   │
└─────────────────┬───────────────────────────────────┘
                  │ stdio/HTTP/SSE
┌─────────────────▼───────────────────────────────────┐
│             FastMCP 2.0 MCP Server                  │
│  ┌─────────────┬─────────────┬─────────────────┐    │
│  │ MCP Tools   │ MCP         │ HTTP/SSE API    │    │
│  │ (15 total)  │ Resources   │                 │    │
│  │             │ MCP Prompts │                 │    │
│  └─────────────┴─────────────┴─────────────────┘    │
└─────────────────┬───────────────────────────────────┘
                  │ python-alfresco-api
┌─────────────────▼───────────────────────────────────┐
│            Alfresco Content Services                │
│         (Community/Enterprise Edition)              │
└─────────────────────────────────────────────────────┘

📄 許可證

本項目採用Apache 2.0許可證 - 詳情請參閱 LICENSE 文件。

🔗 相關項目和參考

• Hyland Alfresco - 內容管理平臺（企業版和社區版）
• python-alfresco-api - 底層的Alfresco API庫
• FastMCP 2.0 - 用於構建MCP服務器的現代框架
• FastMCP文檔 - 完整的FastMCP框架文檔和指南
• 模型上下文協議 - 官方MCP規範和文檔
• Playbooks.com MCP列表 - Python Alfresco MCP Server列表
• PulseMCP.com MCP列表 - Python Alfresco MCP Server列表
• Glama.ai MCP列表 - Glama Alfresco列表，包括Python Alfresco MCP Server列表
• MCPMarket.com MCP列表 - Python Alfresco MCP Server列表

🙋‍♂️ 支持

• 📚 文檔： 中的完整指南
• 💡 示例： 中的實現模式
• 🧪 測試： 中的質量保證
• 🔍 MCP Inspector： 中的開發測試
• 🛠️ 故障排除： 中的問題解決
• 🐛 問題反饋：GitHub問題

---

🚀 本MCP服務器使用 python-alfresco-api 和 FastMCP 2.0 構建