Berlin Services MCP Server

🚀 柏林服務MCP服務器 - 增強版

這是一個用於柏林城市服務（Dienstleistungen）的生產級模型上下文協議（MCP）服務器。它具備彈性緩存、高級搜索、PDF表單發現和填寫等功能。

✨ 主要特性

• 綜合工具：搜索、瀏覽柏林服務並獲取詳細信息。
• 表單管理：發現、分析和填寫各種服務的PDF表單。
• 彈性緩存：經過性能優化，具備智能回退機制，支持離線使用。
• 遠程同步：支持本地和遠程（雲）部署。

🔧 技術細節

1. 數據來源

服務器從官方的 柏林城市服務API 獲取數據。

• 即時獲取：像 search_services 和 get_service_details 這樣的工具會調用即時API。
• 彈性緩存：實現了雙層緩存（內存 + 磁盤），以確保高性能和離線可靠性。
• 智能回退：如果API不可用且沒有緩存，服務器會回退到一組核心服務以保持功能可用。

2. 高級PDF處理

服務器由 PyMuPDF (fitz) 提供支持，提供複雜的文檔處理功能：

• 字段提取：自動檢測城市服務器上託管的PDF表單中的可填寫字段。
• 智能填寫：使用智能匹配和常見翻譯片段將用戶數據映射到PDF字段。
• 循環保護：包含一個 LoopProtector 以防止工具的冗餘執行和大語言模型循環。
• 視覺預覽：可以將PDF的特定頁面渲染為JPEG，以便在聊天中快速查看（無需離開聊天即可驗證）。

3. 部署模式

• 本地模式：針對Claude Desktop使用進行了優化。在此模式下，可以使用 open_file_locally 直接用系統默認查看器打開填寫好的PDF。
• 遠程/雲模式：設計用於在Fly.io或Railway等平臺上部署。用安全同步和聊天內預覽取代本地文件打開功能。

📦 安裝指南

前提條件

• Python 3.11或更高版本
• uv（推薦）或 pip

使用 uv（推薦）

1. 安裝依賴並同步環境：

   uv sync
   

2. 以模塊形式運行服務器：

   export PYTHONPATH=$PYTHONPATH:$(pwd)/src && uv run python -m berlin_mcp.main
   

   注意：如果通過 uv sync 安裝了包，也可以直接運行：

   uv run berlin-mcp
   

使用 pip

1. 安裝依賴：

   pip install -r requirements.txt
   

2. 運行服務器：

   export PYTHONPATH=$PYTHONPATH:$(pwd)/src && python -m berlin_mcp.main
   

📚 詳細文檔

Claude Desktop配置

將以下內容添加到Claude Desktop配置文件中。將 /Users/mananshah/Desktop/Berlin-Services-MCP-Server 替換為實際文件夾的絕對路徑。

macOS

文件位置：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "berlin-services": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/YourUser/Desktop/Berlin-Services-MCP-Server",
        "python",
        "-m",
        "berlin_mcp.main"
      ],
      "env": {
        "PYTHONPATH": "src"
      }
    }
  }
}

Windows

文件位置：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "berlin-services": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\YourUser\\Desktop\\Berlin-Services-MCP-Server",
        "python",
        "-m",
        "berlin_mcp.main"
      ],
      "env": {
        "PYTHONPATH": "src"
      }
    }
  }
}

💻 使用示例

工具和資源

服務器提供以下工具，幫助你瀏覽和管理柏林城市服務：

⚠️ 重要提示

在遠程服務器上填寫的PDF表單應下載後使用 delete_filled_form 工具刪除，以確保數據隱私。