OpenBudget MCP サーバー

OpenBudget API へのアクセスを提供し、さまざまな予算関連のデータセットのクエリと検索を可能にする MCP サーバー。

説明

このプロジェクトは、イスラエルのOpenBudgetデータと連携するFastMCPサーバーを提供します。これにより、予算データ、契約、支援情報への容易なアクセスが可能になります。OpenBudget APIとMCPクライアント間の橋渡しとして機能します。

このプロジェクトは、 OpenBudget/BudgetKeyチームの素晴らしい仕事のおかげで実現しました。

特徴

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

要件

Python 3.10以上
UVパッケージマネージャー

インストール

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

使用法

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

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

fastmcp install server.py

MCP Inspector を使用したテストの場合 ( MCP Inspectorで方法について学習します):

fastmcp dev server.py

利用可能なデータセット

利用可能なデータセットは次のとおりです。

予算項目データ
収入項目データ
サポートデータ
契約データ
エンティティデータ
予算変更要求データ
予算変更取引データ

MCPツール

データセット情報を取得する

列やデータベーススキーマなど、データセットの構造に関する情報を取得します。

検索データセット

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

クエリデータセット

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

MCPリソース

利用可能なデータセット

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

エラー処理

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

データセット名が無効です
無効なSQLクエリ
APIリクエストの失敗
ネットワーク接続の問題

APIドキュメント

このサーバーはOpenBudget APIに基づいています。APIエンドポイントとデータ構造の詳細については、 budgetkey.yamlのOpenAPI仕様を参照してください。

貢献

DataGov Israel MCPサーバーの改善にご協力いただける方は大歓迎です。新しいツールの追加、既存の機能の強化、ドキュメントの改善など、皆様からの貴重なご意見をお待ちしております。

その他の MCP サーバーおよび実装パターンの例については、モデルコンテキストプロトコルサーバーリポジトリを参照してください。

ライセンス

このプロジェクトは、以下の二重ライセンスを受けています。

MITライセンス
クリエイティブ・コモンズ表示-継承 4.0 国際ライセンス

詳細については、 LICENSEファイルを参照してください。

OpenBudget MCP Server

Integrations