OpenBudget MCP 服务器

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

描述

该项目提供了一个 FastMCP 服务器，用于与以色列的 OpenBudget 数据进行接口。
它使访问预算数据、合同和支持信息变得容易。
它充当 OpenBudget API 和 MCP 客户端之间的桥梁。

本项目之所以能够实现，要感谢 OpenBudget/BudgetKey 团队的出色工作。

特性

• 全面访问以色列政府预算数据
• 与 OpenBudget API 实时集成
• 跨多个数据类别的全面搜索功能
• 历史预算跟踪和分析
• 合同和支持付款信息检索
• 易于使用的 MCP 接口供客户端应用程序使用

要求

• Python 3.10 或更高版本
• uv 包管理器

安装

bash
git clone
cd OpenBudget-mcp
uv venv
.venvScriptsactivate
uv pip install -r pyproject.toml
uv lock

使用

使用以下方法之一安装并运行服务器：

1. 对于使用 Visual Studio Code (使用 Copilot)：
   前往 vscode/mcp.json 并将 {YOUR-LOCAL-PATH} 替换为您克隆仓库的路径。
   VSCode 应该会自动发现您的服务器。
   如果不起作用，请确保在 vscode://settings/mcp 中启用了 MCP & MCP.Discovery。
   确保在您的 VSCode Copilot 中启用了代理模式。
   

2. 对于使用 Claude AI 助手：
   bash
   fastmcp install server.py

3. 用于通过 MCP Inspector 进行测试（学习如何在 MCP Inspector）：
   bash
   fastmcp dev server.py

可用数据集

以下数据集可用：

• budget_items_data
• income_items_data
• supports_data
• contracts_data
• entities_data
• budgetary_change_requests_data
• budgetary_change_transactions_data

MCP 工具

get_dataset_info

获取有关数据集结构的信息，包括其列和数据库模式。

search_dataset

在一个数据集中执行全文搜索。

query_dataset

对数据集执行 SQL 查询。

MCP 资源

available_datasets

获取所有可用数据集的列表。

错误处理

工具将在以下情况下返回适当的错误消息：

• 无效的数据集名称
• 无效的 SQL 查询
• API 请求失败
• 网络连接问题

API 文档

服务器基于 OpenBudget API。有关 API 端点和数据结构的更多详细信息，请参阅 budgetkey.yaml 中的 OpenAPI 规范。

贡献

我们欢迎贡献以帮助改进 DataGov Israel MCP 服务器。
无论您是想添加新工具、增强现有功能还是改进文档，您的输入都是宝贵的。

有关其他 MCP 服务器和实现模式的示例，请参阅 Model Context Protocol 服务器仓库。

许可证

本项目采用双重许可：

• MIT 许可证
• 创作共用署名-相同方式共享 4.0 国际许可证

详情请参见 LICENSE 文件。