ILBudget-mcp

ILBudget-mcp

OpenBudget API を通じてイスラエルの予算データにアクセスする MCP サーバーです。

説明

このプロジェクトは、イスラエルの OpenBudget データと連携する FastMCP サーバーを提供します。
予算データ、契約、支援情報に簡単にアクセスできます。
OpenBudget API と MCP クライアントをつなぐブリッジとして機能します。

このプロジェクトは、OpenBudget/BudgetKey チームの素晴らしい取り組みのおかげで実現しました。
この MCP サーバーで使用している API の詳細については、チームのUsingTheAPIをご覧ください。
独自のクエリやツールを作成する場合は、Redashを使ってテストできます（私のクエリはILBudgetServer.pyで確認できます）。

機能

• イスラエルの政府予算データにフルアクセスできます
• OpenBudget API とリアルタイムに連携します
• 複数のデータカテゴリにわたる包括的な検索機能を備えています
• 過去の予算の追跡と分析ができます
• 契約と支援金の支払いに関する情報を取得できます
• クライアントアプリケーションから使いやすい MCP インターフェースを提供します

必要条件

• Python 3.10 以降
• uv パッケージマネージャー

インストール

git clone <repository-url>
cd ILBudget-mcp
uv venv
.venv\Scripts\activate
uv pip install -r pyproject.toml
uv lock

使用方法

以下のいずれかの方法でサーバーをインストールして実行します。

1. Visual Studio Code（Copilot を使用）で使用する場合：
   vscode/mcp.jsonに移動し、{YOUR-LOCAL-PATH} をリポジトリをクローンしたパスに置き換えます。
   VSCode によってサーバーが自動的に検出されるはずです。
   動作しない場合は、vscode://settings/mcpで MCP と MCP.Discovery が有効になっていることを確認してください。
   vscode の Copilot でエージェントモードを有効にしてください。
   

2. Claude AI Assistantで使用する場合：

fastmcp install ILBudgetServer.py

3. MCP Inspector でテストする場合（詳しくはMCP Inspectorをご覧ください）：

fastmcp dev ILBudgetServer.py

利用可能なツール

• get_budget() - 予算全体の構造を取得します
• get_detailed_budget_for_specific_parent(parent) - 指定した親項目の下にある詳細な予算項目を取得します
• get_budget_history_for_code(code) - 特定の予算コードの過去のデータを取得します
• get_contract(code) - 特定の予算コードの契約情報を取得します
• get_supports(code) - 特定の予算コードの支援金の支払い情報を取得します
• search(searchTerm, searchType) - 複数のカテゴリを対象に一般検索を実行します

依存関係

• fastmcp >= 2.1.1
• requests >= 2.32.3

貢献

DataGov Israel MCP サーバーの改善に役立つ貢献を歓迎します。
新しいツールの追加、既存機能の強化、ドキュメントの改善など、皆さまからのご協力をお待ちしています。

ほかの MCP サーバーの例や実装パターンについては、Model Context Protocol サーバーリポジトリをご覧ください。

ライセンス

このプロジェクトは、以下のデュアルライセンスで提供されています。

• MIT License
• Creative Commons Attribution-ShareAlike 4.0 International License

詳細については、LICENSEファイルをご覧ください。