ILBudget-mcp

ILBudget-mcp

用于通过 OpenBudget API 访问以色列预算数据的 MCP 服务。

描述

此项目提供了一个 FastMCP 服务，用于对接以色列的 OpenBudget 数据。
方便地访问预算数据、合同和拨款信息。
它充当 OpenBudget API 与 MCP 客户端之间的桥梁。

本项目的实现离不开 OpenBudget/BudgetKey 团队的出色工作。
有关此 MCP 服务所用 API 的更多详情，请参阅他们的 UsingTheAPI。
如果你想编写自己的查询或工具，可以使用他们的 Redash 进行测试（你可以在 ILBudgetServer.py 中查看我的查询）。

功能

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

要求

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

安装

git clone <repository-url>
cd ILBudget-mcp
uv venv
.venv\Scripts\activate
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 中启用 Agent 模式。
   

2. 用于 Claude AI 助手：

fastmcp install ILBudgetServer.py

3. 使用 MCP Inspector 进行测试（了解方法请参阅 MCP Inspector）：

fastmcp dev ILBudgetServer.py

可用工具

• get_budget() - 获取完整的预算结构
• get_detailed_budget_for_specific_parent(parent) - 获取特定上级项下的详细预算项目
• get_budget_history_for_code(code) - 获取特定预算代码的历史数据
• get_contract(code) - 获取特定预算代码的合同信息
• get_supports(code) - 获取特定预算代码的拨款付款信息
• search(searchTerm, searchType) - 跨不同类别执行通用搜索

依赖项

• fastmcp >= 2.1.1
• requests >= 2.32.3

贡献

欢迎贡献代码，帮助改进 DataGov Israel MCP 服务。
无论你想添加新工具、增强现有功能，还是改进文档，你的贡献都很有价值。

如需查看其他 MCP 服务示例和实现模式，请参阅 Model Context Protocol 服务仓库。

许可证

本项目采用双重许可：

• MIT 许可证
• Creative Commons Attribution-ShareAlike 4.0 International License

详情请参阅 LICENSE 文件。