Berlin Services MCP Server

🚀 ベルリンサービスMCPサーバー - 強化版

ベルリンの都市サービス（Dienstleistungen）向けの本番グレードのモデルコンテキストプロトコル（MCP）サーバーです。弾力的なキャッシュ、高度な検索、PDFフォームの検出と入力機能を備えています。

✨ 主な機能

• 総合的なツール：ベルリンのサービスを検索、閲覧し、詳細情報を取得できます。
• フォーム管理：さまざまなサービスのPDFフォームを検出、分析し、入力できます。
• 弾力的なキャッシュ：パフォーマンスを最適化し、オフラインでの使用にも対応したインテリジェントなフォールバック機能を備えています。
• リモート同期：ローカルとリモート（クラウド）の両方のデプロイメントをサポートしています。

🔧 技術詳細

1. データ取得

サーバーは公式のベルリン都市サービスAPIからデータを取得します。

• リアルタイム取得：search_servicesやget_service_detailsなどのツールがリアルタイムAPIを呼び出します。
• 弾力的なキャッシュ：メモリとディスクの2層キャッシュを実装し、高いパフォーマンスとオフラインでの信頼性を確保します。
• スマートフォールバック：APIがダウンし、キャッシュが存在しない場合、最小限のコアサービスにフォールバックして機能を維持します。

2. 高度なPDF処理

PyMuPDF (fitz) を使用して、サーバーは高度なドキュメント処理を提供します。

• フィールド抽出：市内のサーバーにホストされているPDFフォームの入力可能なフィールドを自動的に検出します。
• インテリジェントな入力：スマートなマッチングと一般的な翻訳フラグメントを使用して、ユーザーデータをPDFフィールドにマッピングします。
• ループ保護：LoopProtectorを使用して、冗長なツール実行とLLMループを防止します。
• 視覚的なプレビュー：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ツールを使用して削除し、データのプライバシーを確保してください。