MaStR MCP Server

MaStR MCP Server

Marktstammdatenregister（MaStR）向けの MCP サーバーです。MaStR は、ドイツ連邦ネットワーク庁（Bundesnetzagentur）が運営するドイツのエネルギー市場マスターデータ登録簿です。Claude Desktop、Cowork、Claude Code からドイツの発電設備登録簿に直接アクセスできます。

ドイツ語版 / 英語版

特長

21 個のツール — SOAP 14 個（認証情報が必要）、公開ツール 7 個（常時利用可能）

ツール	API	認証	説明
get_unit	SOAP	はい	EEG、CHP、許可、蓄電の情報を含むユニットの詳細を 1 回の呼び出しで取得
search_power_generation_soap	SOAP	はい	発電設備の条件付き検索（20 種類すべてのエネルギー源、郵便番号、容量）
get_actor	SOAP	はい	MaStR 番号で市場参加者の詳細を取得
get_api_quota	SOAP	はい	1 日あたりの API クォータ（使用量／上限）
get_recent_changes	SOAP	はい	差分同期：指定日以降の変更（EEG、CHP、許可、所在地、蓄電）
search_power_consumption_soap	SOAP	はい	電力消費設備の条件付き検索（郵便番号、州、ステータスなど）
search_gas_production_soap	SOAP	はい	ガス生産設備の条件付き検索（容量、郵便番号など）
search_gas_consumption_soap	SOAP	はい	ガス消費設備の条件付き検索（容量、郵便番号など）
search_actors_soap	SOAP	はい	市場参加者の条件付き検索（機能、役割、郵便番号など）
get_location	SOAP	はい	関連するユニットおよび系統接続ポイントを含む所在地の詳細
get_catalog_values	SOAP	はい	カテゴリー ID でカタログ／列挙値（法人形態、メーカーなど）を取得
get_catalog_categories	SOAP	はい	利用可能なすべてのカタログカテゴリーを一覧表示
get_balancing_areas	SOAP	はい	バランシングエリア（Y-EIC コード、制御エリア）。DSO による絞り込みも可能
get_grid_connection	SOAP	はい	ユニットの系統接続ポイント（電圧レベル、所在地、同一地点のユニット）
search_power_generation_public	JSON	いいえ	発電設備（27 個のフィルターキー）
search_actors_public	JSON	いいえ	市場参加者（23 個のフィルターキー）
search_power_consumption_public	JSON	いいえ	電力消費設備（29 個のフィルターキー）
search_gas_production_public	JSON	いいえ	ガス生産／ガス貯蔵（30 個のフィルターキー）
search_gas_consumption_public	JSON	いいえ	ガス消費設備（30 個のフィルターキー）
search_grid_connections_public	JSON	いいえ	系統接続ポイントと所在地（4 種類、12～20 個のフィルターキー）
get_local_time	SOAP	いいえ	接続テスト（常時利用可能）

10 種類のフィルター演算子

接尾辞	演算子	説明
(なし) / =	eq	等しい（デフォルト）
!=	neq	等しくない
%	ct	含む
!%	nct	含まない
:	sw	で始まる
$	ew	で終わる
>	gt	より大きい
<	lt	より小さい
?	null	NULL である
! / !?	nn	NULL ではない

20 種類のエネルギー源

すべての技術キーワードは英語で利用できます（ドイツ語の別名も使用できます）。

wind, solar, biomass, hydro, storage, geo, mine_gas, sewage_sludge, solar_thermal, pressure_relief_gas/pressure_relief_water, natural_gas, hard_coal, lignite, mineral_oil, other_gases, waste, heat, hydrogen, nuclear。

認証情報がない場合は、公開ツール 7 個（発電、電力消費、ガス生産、ガス消費、市場参加者、系統接続の検索と接続テスト）を利用できます。認証情報がある場合（.env）は、追加の SOAP ツール 14 個（詳細取得、条件付き検索、カタログ、バランシングエリアなど）が登録されます。

インストール

前提条件

• Python >= 3.10
• uv（推奨）または pip
• MaStR ウェブサービスアカウント（SOAP API ツール用、任意）：https://www.marktstammdatenregister.de

ステップ 1：プロジェクトをクローン／コピーする

git clone https://github.com/UliRCS/mastr-mcp-server.git
cd mastr-mcp-server

ステップ 2：依存関係をインストールする

uv を使用する場合（推奨）：

uv sync

pip を使用する場合：

pip install -e .

ステップ 3：認証情報を .env に保存する

サーバーは、（python-dotenv を介して）プロジェクトディレクトリ内の .env ファイルから認証情報を自動的に読み込みます。これが推奨される方法です。

cp .env.example .env
# Edit .env and fill in your values:
# MASTR_USER=SEM123456789012
# MASTR_TOKEN=your-webservice-token-540-chars

.env は .gitignore で除外されているため、トークンがリポジトリに含まれることはありません。

別の方法：OS の環境変数、または Claude Desktop の設定の env ブロックにも変数を設定できます。OS の値が優先されます。

ステップ 4：テストする

# Quick test
uv run mastr_mcp_server.py

# Or with the MCP Inspector
npx @modelcontextprotocol/inspector uv run mastr_mcp_server.py

Claude Desktop / Cowork の設定

Claude Desktop の設定ファイルを開きます。

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

.env がプロジェクトディレクトリにある場合、env ブロックは省略できます。

{
  "mcpServers": {
    "mastr": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/mastr-mcp-server",
        "mastr_mcp_server.py"
      ]
    }
  }
}

重要： --directory のパスを、お使いのシステム上の実際の場所に変更してください。

Claude Code の設定

claude mcp add mastr \
  --command "uv" \
  --args "run" "--directory" "/path/to/mastr-mcp-server" "mastr_mcp_server.py" \
  --env "MASTR_USER=SOM123456789012" \
  --env "MASTR_TOKEN=your-webservice-token"

使用例

• 「風力タービン SEE966095906064 の詳細を表示して」 -> get_unit
• 「郵便番号 49074 にあるすべての太陽光発電所を検索して」 -> search_power_generation_public({'tech': 'solar', 'postcode': '49074'})
• 「郵便番号エリア 23... にある、出力が 1200～3500 kW の風力タービン」 -> search_power_generation_public({'tech': 'wind', 'capacity>': 1200, 'capacity<': 3500, 'postcode:': '23'})
• 「EEG キーのない風力タービン」 -> search_power_generation_public({'tech': 'wind', 'eeg_key?': ''})
• 「郵便番号 49074 にある、風力以外のすべてのユニット」 -> search_power_generation_public({'tech!=': '2497', 'postcode': '49074'})
• 「Power-to-Gas 水素プラント」 -> search_gas_production_public({'gas_technology': 'Power-to-Gas (Wasserstoff)'})
• 「バイエルン州の高電圧需要家」 -> search_power_consumption_public({'bundesland': 'Bayern', 'voltage_level': 'Hochspannung'})
• 「電力を生成する H-Gas のガス需要家」 -> search_gas_consumption_public({'gas_quality': 'H-Gas', 'gas_for_power': True})
• 「ニーダーザクセン州で、接続顧客数が 100,000 を超える配電系統運用者」 -> search_actors_public({'function': 'Stromnetzbetreiber', 'dso_large': True, 'bundesland': 'Niedersachsen'})
• 「郵便番号 49074 にある、中電圧の発電用系統接続ポイント」 -> search_grid_connections_public('power_generation', {'postcode': '49074', 'voltage_level': 'Mittelspannung'})
• 「H-Gas のガス受け入れポイント」 -> search_grid_connections_public('gas_production', {'gas_quality': 'H-Gas'})

プロジェクト構成

mastr-mcp-server/
├── mastr_mcp_server.py           # Entry point (imports package, starts server)
├── mastr_mcp/                     # Main package
│   ├── __init__.py               # Package init, conditional tool registration
│   ├── config.py                 # Constants, env vars, technology mappings
│   ├── serialization.py          # SOAP->JSON, MS-AJAX date conversion
│   ├── client.py                 # SOAP client, HTTP fetch, retry helper
│   ├── filters.py                # Filter builder, column mappings, dropdown loading
│   ├── server.py                 # FastMCP instance with instructions
│   ├── tools_soap.py             # SOAP tools (14)
│   ├── tools_public.py           # Public JSON tools (7)
│   └── resources.py              # MCP Resources (4)
├── *_dropdowns.json               # Dropdown ID mappings (5 files, from live API)
├── pyproject.toml                 # Dependencies and metadata
├── .env                           # Credentials (not in git)
└── .env.example                  # Credential template

セキュリティに関する注意事項

• MaStR トークンは機密情報です。.env に保存し、リポジトリには決して含めないでください。
• サーバーは読み取り操作のみを実行します（登録や変更は行いません）。
• 1 日あたりの上限：ユーザーごとに SOAP API 呼び出し 100,000 回（公開 JSON は無制限です）。
• TLS 1.2 接続のみ受け付けます。

ライセンス

MIT