Openbudget

🚀 OpenBudget MCP サーバー

OpenBudget API へのアクセスを提供する MCP サーバーです。様々な予算関連のデータセットをクエリし、検索することができます。

🚀 クイックスタート

このプロジェクトは、イスラエルのオープン予算データインターフェースと接続するための FastMCP サーバーを提供します。予算データ、契約情報、およびサポート資料に簡単にアクセスできます。また、OpenBudget API と MCP クライアントの間の橋渡し役として機能します。このプロジェクトの実現は、OpenBudget/BudgetKey チームの素晴らしい仕事のおかげです。

✨ 主な機能

• イスラエル政府の予算データへの全面的なアクセス
• OpenBudget API へのリアルタイム統合
• 複数のデータカテゴリにおける総合的な検索機能
• 過去の予算の追跡と分析
• 契約および支払い情報の検索
• クライアントアプリケーションに使いやすい MCP インターフェース

📦 インストール

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

💻 使用例

基本的な使用法

以下の方法でサーバーをインストールし、実行します。

Visual Studio Code（Copilot と一緒に使用）の場合

1. vscode/mcp.json に移動し、{YOUR-LOCAL-PATH} をあなたがリポジトリをクローンしたパスに置き換えます。
2. VSCode が自動的にサーバーを検出するはずです。
3. もし検出されない場合は、VSCode の MCP & MCP.Discovery 設定が有効になっていることを確認してください（vscode://settings/mcp で確認）。
4. VSCode Copilot で代理モードが有効になっていることを確認してください。

Claude AI アシスタントの場合

fastmcp install server.py

MCP Inspector でテストする場合（詳細は MCP Inspector を参照）

fastmcp dev server.py

📚 ドキュメント

利用可能なデータセット

以下のデータセットが利用可能です。

• 予算項目データ
• 収入項目データ
• 補助金情報データ
• 契約データ
• エンティティデータ
• 予算修正要求データ
• 予算修正トランザクションデータ

MCP ツール

get_dataset_info

特定のデータセットの構造情報（フィールドやデータベーススキーマ）を取得します。

search_dataset

データセット内で全文検索を実行します。

query_dataset

データセットに対して SQL クエリを実行します。

MCP リソース

available_datasets

すべての利用可能なデータセットのリストを取得します。

エラー処理

ツールは以下の場合に適切なエラーメッセージを返します。

• データセット名が無効な場合
• SQL クエリが無効な場合
• ネットワーク接続に問題がある場合
• リソースが見つからない場合

API ドキュメント

API の詳細情報については、OpenAPI 仕様ファイル openapi.yaml を参照してください。

このプロジェクトは [OpenBudget] によってメンテナンスされており、透明でアクセスしやすい予算データを提供することを目的としています。詳細やサポートが必要な場合は、公式ウェブサイトにアクセスするか、サポートチームに連絡してください。