OpenBudget MCP Server

Ein MCP-Server, der Zugriff auf die OpenBudget-API bietet und Ihnen die Abfrage und Suche nach verschiedenen budgetbezogenen Datensätzen ermöglicht.

Beschreibung

Dieses Projekt bietet einen FastMCP-Server, der mit den israelischen OpenBudget-Daten interagiert. Er ermöglicht einfachen Zugriff auf Budgetdaten, Verträge und Supportinformationen. Er dient als Brücke zwischen der OpenBudget-API und MCP-Clients.

Dieses Projekt ist nur dank der großartigen Arbeit des OpenBudget/BudgetKey -Teams möglich.

Related MCP server: Data.gov.il MCP Server

Merkmale

• Vollständiger Zugriff auf die Haushaltsdaten der israelischen Regierung

• Echtzeitintegration mit der OpenBudget-API

• Umfassende Suchfunktionen für mehrere Datenkategorien

• Historische Budgetverfolgung und -analyse

• Abruf von Vertrags- und Supportzahlungsinformationen

• Benutzerfreundliche MCP-Schnittstelle für Client-Anwendungen

Anforderungen

• Python 3.10 oder höher

• UV -Paketmanager

Installation

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

Verwendung

Installieren und führen Sie den Server mit einer der folgenden Methoden aus:

1. Zur Verwendung mit Visual Studio Code (mit Copilot) : Gehen Sie zu vscode/mcp.json und ersetzen Sie {YOUR-LOCAL-PATH} durch den Pfad, in dem Sie das Repository geklont haben. VSCode sollte Ihren Server automatisch erkennen. Falls das nicht funktioniert, stellen Sie sicher, dass Sie MCP und MCP.Discovery in vscode://settings/mcp aktiviert haben. Aktivieren Sie den Agentenmodus in Ihrem vscode Copilot.

2. Zur Verwendung mit Claude AI Assistant :

fastmcp install server.py

3. Zum Testen mit MCP Inspector (Erfahren Sie unter MCP Inspector , wie das geht):

fastmcp dev server.py

Verfügbare Datensätze

Folgende Datensätze stehen zur Verfügung:

• budget_items_data

• Einkommensartikeldaten

• unterstützt_Daten

• Vertragsdaten

• Entitätendaten

• Daten zu Budgetänderungsanfragen

• Budgetänderungstransaktionsdaten

MCP-Tools

get_dataset_info

Erhalten Sie Informationen zur Struktur eines Datensatzes, einschließlich seiner Spalten und des Datenbankschemas.

Suchdatensatz

Führen Sie eine Volltextsuche innerhalb eines Datensatzes durch.

Abfragedatensatz

Führen Sie SQL-Abfragen für einen Datensatz aus.

MCP-Ressourcen

verfügbare_Datensätze

Erhalten Sie eine Liste aller verfügbaren Datensätze.

Fehlerbehandlung

In den folgenden Fällen geben die Tools entsprechende Fehlermeldungen zurück:

• Ungültiger Datensatzname

• Ungültige SQL-Abfrage

• API-Anforderungsfehler

• Probleme mit der Netzwerkkonnektivität

API-Dokumentation

Der Server basiert auf der OpenBudget-API. Weitere Informationen zu den API-Endpunkten und der Datenstruktur finden Sie in der OpenAPI-Spezifikation in budgetkey.yaml .

Beitragen

Wir freuen uns über Beiträge zur Verbesserung des BudgetKey Israel MCP-Servers. Egal, ob Sie neue Tools hinzufügen, bestehende Funktionen erweitern oder die Dokumentation verbessern möchten – Ihr Beitrag ist wertvoll.

Beispiele für andere MCP-Server und Implementierungsmuster finden Sie im Repository der Model Context Protocol-Server .

Lizenz

Dieses Projekt ist doppelt lizenziert unter:

• MIT-Lizenz

• Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 4.0 International Lizenz

Weitere Einzelheiten finden Sie in der Datei LICENSE .