OpenBudget MCP Server

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

描述

该项目提供了一个与以色列OpenBudget数据接口的FastMCP服务器。</br> 便于访问预算数据、合同和支持信息。</br> 它充当OpenBudget API和MCP客户端之间的桥梁。</br>

此项目得益于OpenBudget/BudgetKey团队的出色工作。</br>

特性

• 完整访问以色列政府预算数据
• 实时集成OpenBudget API
• 跨多个数据类别的全面搜索能力
• 历史预算跟踪和分析
• 合同和支持支付信息检索
• 客户端应用程序易于使用的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

使用方法

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

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

2. 用于Claude AI Assistant：

fastmcp install server.py

3. 用于MCP Inspector测试：

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规范。

贡献

我们欢迎贡献以帮助改进BudgetKey以色列MCP服务器。</br> 无论您想添加新工具、增强现有功能还是改进文档，您的意见都是宝贵的。</br>

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

许可证

本项目采用双重许可：

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

详情请参阅LICENSE文件。