Servidor MCP de OpenBudget

Un servidor MCP que proporciona acceso a la API de OpenBudget, lo que le permite consultar y buscar diversos conjuntos de datos relacionados con el presupuesto.

Descripción

Este proyecto proporciona un servidor FastMCP que interactúa con los datos de OpenBudget de Israel. Esto facilita el acceso a datos presupuestarios, contratos e información de apoyo. Actúa como puente entre la API de OpenBudget y los clientes MCP.

Este proyecto es posible sólo gracias al increíble trabajo del equipo de OpenBudget/BudgetKey .

Related MCP server: Data.gov.il MCP Server

Características

• Acceso completo a los datos del presupuesto gubernamental de Israel

• Integración en tiempo real con la API de OpenBudget

• Capacidades de búsqueda integrales en múltiples categorías de datos

• Seguimiento y análisis del presupuesto histórico

• Recuperación de información de pagos de contratos y soporte

• Interfaz MCP fácil de usar para aplicaciones cliente

Requisitos

• Python 3.10 o superior

• administrador de paquetes uv

Instalación

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

Uso

Instale y ejecute el servidor utilizando uno de estos métodos:

1. Para usar con Visual Studio Code (con Copilot) : Vaya a vscode/mcp.json y reemplace {YOUR-LOCAL-PATH} con la ruta donde clonó el repositorio. VSCode debería detectar su servidor automáticamente. Si esto no funciona, asegúrese de haber habilitado MCP y MCP.Discovery en vscode://settings/mcp . Asegúrese de habilitar el modo agente en vscode Copilot.

2. Para usar con Claude AI Assistant :

fastmcp install server.py

3. Para realizar pruebas con MCP Inspector (obtenga información sobre cómo hacerlo en MCP Inspector ):

fastmcp dev server.py

Conjuntos de datos disponibles

Los siguientes conjuntos de datos están disponibles:

• datos de partidas presupuestarias

• datos de artículos de ingresos

• soporta_datos

• datos_de_contratos

• datos_de_entidades

• datos de solicitudes de cambio presupuestario

• datos de transacciones de cambio presupuestario

Herramientas MCP

obtener_información_del_conjunto_de_datos

Obtenga información sobre la estructura de un conjunto de datos, incluidas sus columnas y el esquema de base de datos.

conjunto de datos de búsqueda

Realizar una búsqueda de texto completo dentro de un conjunto de datos.

conjunto de datos de consulta

Ejecutar consultas SQL en un conjunto de datos.

Recursos de MCP

conjuntos de datos disponibles

Obtenga una lista de todos los conjuntos de datos disponibles.

Manejo de errores

Las herramientas devolverán mensajes de error apropiados en los siguientes casos:

• Nombre de conjunto de datos no válido

• Consulta SQL no válida

• Errores en las solicitudes de API

• Problemas de conectividad de red

Documentación de la API

El servidor se basa en la API de OpenBudget. Para obtener más información sobre los puntos de conexión de la API y la estructura de datos, consulte la especificación de OpenAPI en budgetkey.yaml .

Contribuyendo

Agradecemos sus contribuciones para mejorar el servidor MCP de DataGov Israel. Ya sea que desee agregar nuevas herramientas, mejorar la funcionalidad existente o mejorar la documentación, su aporte es valioso.

Para obtener ejemplos de otros servidores MCP y patrones de implementación, consulte el repositorio de servidores de Protocolo de contexto de modelo .

Licencia

Este proyecto cuenta con doble licencia bajo:

• Licencia MIT

• Licencia Creative Commons Atribución-CompartirIgual 4.0 Internacional

Consulte el archivo LICENCIA para obtener más detalles.