OpenBudget MCP サーバー

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

説明

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

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

特徴

• イスラエル政府予算データへの完全アクセス

• OpenBudget APIとのリアルタイム統合

• 複数のデータカテゴリにわたる包括的な検索機能

• 過去の予算の追跡と分析

• 契約およびサポート支払い情報の取得

• クライアントアプリケーション用の使いやすいMCPインターフェース

要件

• Python 3.10以上

• UVパッケージマネージャー

インストール

使用法

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

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

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

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

利用可能なデータセット

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

• 予算項目データ

• 収入項目データ

• サポートデータ

• 契約データ

• エンティティデータ

• 予算変更要求データ

• 予算変更取引データ

MCPツール

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

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

検索データセット

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

クエリデータセット

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

MCPリソース

利用可能なデータセット

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

エラー処理

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

• データセット名が無効です

• 無効なSQLクエリ

• APIリクエストの失敗

• ネットワーク接続の問題

APIドキュメント

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

貢献

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

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

ライセンス

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

• MITライセンス

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

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