OpenBudget MCP Server

BudgetKey MCP服务器

一个MCP（模型上下文协议）服务器，通过Claude和其他人工智能助手提供对以色列国家预算（BudgetKey）API的访问。

概述

BudgetKey MCP服务器使AI助手能够查询和分析以色列的预算数据，包括：

• 预算簿数据 国家预算（Planned and Executed Budget）
• 支持计划 -国家提供的预算支持计划
• 支持交易 -支持计划下的个人付款
• 采购合同 -政府与供应商签订的合同
• 实体 -关于组织、公司、协会的信息
• 国家收入 -税收、费用和收入数据
• 预算变更请求 -修改预算的请求

数据可从1997年到2025年获得。

特性

服务器提供三个主要工具：

数据信息

获取有关任何数据集的全面信息，包括其列和数据库模式。在查询数据集之前，请务必使用此工具。

参数：

• dataset：数据集ID（例如。， budget_items_data, contracts_data)

数据集全文搜索

对数据集执行自由文本搜索以查找相关项目。在执行数据库查询之前，使用此功能定位文本标识符。

参数：

• dataset：数据集ID
• q：搜索查询文本

数据集数据库查询

在数据集的数据库上执行SQL查询以检索精确的信息。始终包括 item_url 字段提供数据的直接链接。

参数：

• dataset：数据集ID
• query：PostgreSQL兼容的SQL查询
• page_size：要返回的行数（默认值：50）

可用数据集

安装

📖 有关与Claude Desktop、VS Code、Cursor和其他客户端的详细集成说明，请参阅 集成指南

快速入门：克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "budgetkey": {
      "type": "http",
      "url": "https://next.obudget.org/mcp"
    }
  }
}

重新启动Claude Desktop，您就可以查询以色列的预算数据了！

使用Docker

docker run -p 8000:8000 ghcr.io/openbudget/budgetkey-mcp:latest

服务器将在以下时间可用 http://localhost:8000/mcp

备注Docker镜像托管在OpenBudget组织下的GitHub容器注册表上。

来源

git clone https://github.com/OpenBudget/budgetkey-mcp.git
cd budgetkey-mcp
pip install -r requirements.txt
python server.py

使用示例

示例1：查找预算信息

1. 使用 DatasetInfo 随着 dataset="budget_items_data" 理解模式
2. 使用 DatasetFullTextSearch 随着 dataset="budget_items_data" 和 q="חינוך" 查找与教育相关的项目
3. 使用 DatasetDBQuery 为了获得精确的数据：

   SELECT year, code, title, net_allocated, net_executed, item_url
   FROM budget_items_data
   WHERE year = 2025 AND title LIKE '%חינוך%'
   ORDER BY net_allocated DESC
   LIMIT 10

示例2：查找组织合同

1. 使用 DatasetInfo 随着 dataset="entities_data" 理解实体结构
2. 使用 DatasetFullTextSearch 随着 dataset="entities_data" 和 q="אוניברסיטת תל אביב" 查找实体ID
3. 使用 DatasetInfo 随着 dataset="contracts_data" 理解合同模式
4. 使用 DatasetDBQuery 查询该实体的合同

API基本URL

服务器连接到： https://next.obudget.org

这可以通过以下方式进行定制 BUDGETKEY_API_BASE 环境变量。

工作流程

使用此MCP服务器时，请执行以下步骤：

1. 识别：确定需要哪些数据集和标识符
2. 学习架构：使用 DatasetInfo 了解数据集结构
3. 搜索：使用 DatasetFullTextSearch 查找精确的标识符（如果需要）
4. 查询：使用 DatasetDBQuery 使用SQL获取准确信息
5. 礼物：使用 item_url 字段和提供下载链接 download_url

发展

项目结构

budgetkey-mcp/
├── server.py              # Main MCP server implementation
├── requirements.txt       # Python dependencies
├── Dockerfile            # Docker container definition
├── ci.sh                 # CI/CD build script
├── .github/
│   └── workflows/
│       └── deploy.yml    # GitHub Actions deployment
└── README.md             # This file

建筑

docker build -t ghcr.io/openbudget/budgetkey-mcp:latest .

CI/CD：GitHub Actions工作流在每次推送时自动构建Docker镜像并将其发布到GitHub容器注册表 main.

测试

# Start the server
python server.py

# Test the health check endpoint
curl http://localhost:8000/mcp/health

# To test MCP functionality, configure Claude Desktop to use http://localhost:8000/mcp
# or use an MCP client library to connect to the server

贡献

欢迎投稿！请在GitHub存储库上打开问题或拉取请求。

许可证

此项目遵循与BudgetKey项目相同的许可证。

链接

• 集成指南 -Claude Desktop、VS Code、Cursor和Python的详细设置
• -GitHub容器注册表
• BudgetKey网站
• BudgetKey API文档
• MCP协议
• FastMCP框架

支持

如有疑问或问题：

• 在GitHub上打开一个问题
• 通过主网站联系BudgetKey团队

______________________________________________________________________

注： 由于以色列的预算数据包含希伯来语信息，因此服务器可以用希伯来语和英语进行高效通信。