mcp-belgium

mcp-belgium

ベルギーの公共 API 向け MCP サーバーをひとつにまとめています。

mcp-belgium は、一般公開されているエントリーポイントです。ベルギーの交通、公式統計、オープンデータ、住所、気象、大気質、地理空間サービスをまとめた単一の MCP サーバーを公開し、インストールとクライアント設定をそれぞれひとつに集約します。

このパッケージは、公式 MCP Registry に io.github.lacausecrypto/mcp-belgium として公開できるよう準備されています。

利用する理由

• npm パッケージひとつ
• クライアント設定に追加する MCP サーバーのエントリーひとつ
• irail_*、statbel_*、best_*、kmi_*、urban_*、urbis_* などの名前空間付きツール
• 組み込みのカタログツール、リソース、プロンプトにより、LLM はツールを呼び出す前に適切なベルギーの分野を見つけられます
• 上流サービスでキーが必要な場合や、契約が変更された場合に、制限事項を明示します

インストール

直接実行：

npx -y mcp-belgium

pnpm を使用：

pnpm dlx mcp-belgium

グローバルインストール：

pnpm add -g mcp-belgium
mcp-belgium

デフォルトのトランスポートは stdio です。デスクトップ MCP クライアントではこの設定が想定されています。

Claude Desktop

{
  "mcpServers": {
    "belgium": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-belgium"
      ],
      "env": {
        "LOG_LEVEL": "silent"
      }
    }
  }
}

任意の環境変数：

• STIB_API_KEY：ライブ STIB/MIVB ツールを有効にします
• CBEAPI_KEY：ライブ KBO/BCE 企業登録ツールを有効にします
• MCP_TRANSPORT=http：Streamable HTTP 経由でサーバーを実行します
• PORT_BELGIUM=3017：集約サーバーの HTTP ポートを設定します

LLM が利用できるもの

分野別ツールに加えて、mcp-belgium はディスカバリーレイヤーを公開します。

• belgium_catalog_overview
• belgium_list_domains
• belgium_describe_domain
• belgium://catalog
• belgium://catalog.json
• belgium://domain/{domain}
• belgium_capability_guide

これにより、LLM は次のことができます。

• この MCP ひとつから利用できるベルギーの分野を調べる
• どの分野が利用可能、制限付き、またはキーが必要なのかを確認する
• 各分野がどのようなデータを提供するのかを把握する
• 推測に頼らず、適切な名前空間付きツールを選ぶ

主なドメイン

Prefix	Domain	Status	Auth	Main data
irail_*	ベルギー鉄道／iRail	稼働中	なし	駅、接続、運行情報、車両、運行障害
mobility_*	ベルギーのモビリティ／SMOP	稼働中	なし	複数の交通手段を利用した経路検索、事業者、GTFS 参照情報
stib_*	STIB/MIVB ブリュッセル公共交通	稼働中	API キー	待ち時間、停留所、路線、サービスメッセージ
infrabel_*	Infrabel オープンデータ	稼働中	なし	鉄道インフラのデータセットとレコード
kbo_*	ベルギー企業登記	稼働中	API キー	企業検索と企業の詳細
best_*	BeST ベルギー住所	稼働中	なし	住所、自治体、通り、郵便情報
statbel_*	Statbel	稼働中	なし	人口、消費者物価指数、雇用、データセット検索
airquality_*	IRCELINE 大気質	稼働中	なし	観測所、リアルタイム測定値、BelAQI、時系列データ
brussels_*	ブリュッセル地域のオープンデータ	稼働中	なし	データセットとレコード
wallonia_*	ワロン地域のオープンデータ	稼働中	なし	データセットとレコード
kmi_*	KMI／IRM GeoServer	稼働中	なし	観測所、時間ごとの観測データ、WFS の検出
wallonia_geo_*	Wallonia GeoServices	稼働中	なし	ArcGIS フォルダー、サービス、レイヤーのクエリ
urban_*	urban.brussels WFS	稼働中	なし	フィーチャタイプ、スキーマ、GeoJSON フィーチャ
urbis_*	URBIS 公開 WMS	稼働中	なし	WMS レイヤーの検出とマップ URL の生成
datagov_*	data.gov.be 互換レイヤー	制限あり	なし	上流の変更を明示するエラー
flanders_*	Datavindplaats 互換レイヤー	制限あり	API キー	上流の制限を明示するエラー

ドキュメント／Wiki

このリポジトリには、軽量な公開 Wiki として機能する docs/ ツリーが含まれるようになりました。

• ドキュメントのホーム
• インストール
• クライアントの設定
• ドメインカタログ
• 開発
• リリースと npm への公開

ローカル開発

要件：

• Node.js >= 22
• pnpm >= 9

セットアップ：

pnpm install
pnpm run build
pnpm run test
pnpm run typecheck

stdio 経由で集約サーバーを実行します：

pnpm --filter mcp-belgium start:stdio

Streamable HTTP 経由で実行します：

MCP_TRANSPORT=http PORT_BELGIUM=3017 pnpm --filter mcp-belgium start

ワークスペース全体を実行します：

docker compose up --build

モノレポの構成

• packages/core：共有 HTTP、リトライ、キャッシュ、レート制限、XML ヘルパー、MCP レスポンスヘルパー
• packages/mcp-belgium：公開されている集約エントリポイント
• packages/mcp-*：保守、テスト、個別検証のためにモジュール化されたドメイン固有パッケージ

公開されている利用者向けのパスは mcp-belgium です。内部のワークスペースパッケージは開発向けにモジュール化されていますが、公開される mcp-belgium パッケージにはそれらがバンドルされるため、エンドユーザーは npm パッケージを 1 つだけインストールすれば済みます。

上流 API に関する注意点

このプロジェクトは公開されている上流 API をラップします。ベルギーのポータルの中には、認証やエンドポイントの仕様が時間とともに変更されるものがあります。上流 API が公開状態で互換性を保てなくなった場合、このプロジェクトでは、暗黙の失敗ではなく、明示的で機械可読な制限エラーを返す方針です。

現在の例：

• mcp-stib には STIB_API_KEY が必要です
• mcp-kbo には CBEAPI_KEY が必要です
• mcp-data-gov-be は従来のツール仕様を維持しつつ、上流 API の変更を示す明示的なエラーを返します
• mcp-opendata-flanders は従来のツール仕様を維持しつつ、API キーに関する制限を明示的に返します

検証

現在のワークスペースのチェック：

• pnpm run build
• pnpm run test
• pnpm run typecheck
• pnpm audit --prod

ライセンス

MIT。LICENSE をご覧ください。