OpenBudget MCP Server

OpenBudget MCP 服务器

MCP 服务器提供对 OpenBudget API 的访问，允许您查询和搜索各种与预算相关的数据集。

描述

该项目提供了一个 FastMCP 服务器，用于与以色列的 OpenBudget 数据接口。它允许轻松访问预算数据、合同和支持信息。它充当了 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 规范。

贡献

我们欢迎您为改进 DataGov Israel MCP 服务器做出贡献。无论您是想添加新工具、增强现有功能还是改进文档，您的贡献都弥足珍贵。

有关其他 MCP 服务器和实现模式的示例，请参阅模型上下文协议服务器存储库。

执照

该项目已获得双重许可：

• MIT 许可证
• 知识共享署名-相同方式共享 4.0 国际许可协议

有关详细信息，请参阅LICENSE文件。