Berlin Services MCP Server

柏林服务MCP服务器-增强型

用于柏林城市服务的生产级模型上下文协议（MCP）服务器（Dienstleistungen）。它具有弹性缓存、高级搜索、PDF表单发现和填充功能。

特性

• 综合工具：搜索、浏览并获取有关柏林服务的详细信息。
• 表单管理：发现、分析和填写各种服务的PDF表格。
• 弹性缓存：针对性能进行了优化，具有离线使用的智能回退功能。
• 远程同步：支持本地和远程（云）部署。

技术架构

1.数据来源

服务器从官方网站获取数据 柏林城市服务API

• 实时抓取：工具如 search_services 和 get_service_details 点击API直播。
• 弹性缓存：实现双层缓存（内存+磁盘），以确保高性能和离线可靠性。
• 智能回退：如果API关闭且不存在缓存，则它将回退到核心服务的最小集合以保持功能。

2.高级PDF处理

由...驱动 PyMuPDF (fitz)，服务器提供复杂的文档处理：

• 现场提取：自动检测城市服务器上托管的PDF表单中的可填写字段。
• 智能灌装：使用智能匹配和通用翻译片段将用户数据映射到PDF字段。
• 回路保护：包括a LoopProtector 以防止冗余的工具执行和LLM循环。
• 可视化的预览：可以将PDF的特定页面渲染为JPEG，以便在聊天中快速快照（在不离开聊天的情况下用于验证）。

3.部署模式

• 本地模式：针对与Claude Desktop一起使用进行了优化。在这种模式下， open_file_locally 可以使用系统的默认查看器直接打开已填充的PDF。
• 远程/云模式：专为在Fly.io或Railway等平台上部署而设计。将本地文件打开替换为安全同步和聊天预览。

先决条件

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

本地设置

使用 uv （推荐）

1. 安装依赖项并同步环境：

   uv sync

1. 将服务器作为模块运行：

   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

1. 运行服务器：

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

Claude桌面配置

将以下内容添加到您的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"
      }
    }
  }
}

视窗

文件位置： %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 确保数据隐私的工具。