Сервер OpenBudget MCP

Сервер MCP, который обеспечивает доступ к API OpenBudget, позволяя запрашивать и искать различные наборы данных, связанные с бюджетом.

Описание

Этот проект предоставляет сервер FastMCP, который взаимодействует с данными OpenBudget Израиля. Обеспечивая легкий доступ к бюджетным данным, контрактам и информации о поддержке. Он служит мостом между API OpenBudget и клиентами MCP.

Этот проект стал возможен только благодаря потрясающей работе команды OpenBudget/BudgetKey .

Функции

Полный доступ к данным государственного бюджета Израиля
Интеграция в реальном времени с API OpenBudget
Комплексные возможности поиска по нескольким категориям данных
Отслеживание и анализ исторического бюджета
Поиск информации о контрактах и платежах поддержки
Простой в использовании интерфейс 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 должен автоматически обнаружить ваш сервер. Если это не сработает, убедитесь, что вы включили MCP и MCP.Discovery в vscode://settings/mcp . Убедитесь, что вы включили режим агента в вашем vscode copilot.
Для использования с Claude AI Assistant :

fastmcp install server.py

Для тестирования с помощью MCP Inspector (узнайте, как это сделать, на сайте MCP Inspector ):

fastmcp dev server.py

Доступные наборы данных

Доступны следующие наборы данных:

данные_бюджета_элементов
данные_о_элементах_дохода
поддерживает_данные
контракты_данные
сущности_данные
бюджетные_изменения_запросов_данных
бюджетные_изменения_транзакции_данных

Инструменты МКП

получить_информацию_о_наборе_данных

Получите информацию о структуре набора данных, включая его столбцы и схему базы данных.

поиск_набор_данных

Выполнить полнотекстовый поиск в наборе данных.

запрос_набор_данных

Выполнение SQL-запросов к набору данных.

Ресурсы МКП

доступные_наборы_данных

Получите список всех доступных наборов данных.

Обработка ошибок

Инструменты будут возвращать соответствующие сообщения об ошибках в следующих случаях:

Неверное имя набора данных
Неверный SQL-запрос
Ошибки запросов API
Проблемы с сетевым подключением

API-документация

Сервер основан на API OpenBudget. Более подробную информацию о конечных точках API и структуре данных см. в спецификации OpenAPI в budgetkey.yaml .

Внося вклад

Мы приветствуем вклады, которые помогут улучшить сервер DataGov Israel MCP. Хотите ли вы добавить новые инструменты, улучшить существующую функциональность или улучшить документацию, ваш вклад будет ценным.

Примеры других серверов MCP и шаблонов реализации см. в репозитории серверов Model Context Protocol .

Лицензия

Этот проект имеет двойную лицензию:

Лицензия Массачусетского технологического института
Creative Commons Attribution-ShareAlike 4.0 Международная лицензия

Подробную информацию смотрите в файле ЛИЦЕНЗИЯ .

OpenBudget MCP Server

Integrations