Ukraine Public Spending

@pipeworx/ukraine-public-spending

来自 spending.gov.ua 的乌克兰国家财政部付款交易：公共机构向谁付款、哪些公共机构向某供应商付款、金额及用途，均可按 EDRPOU 代码查询。将供应商的付款与其 ProZorro 招标关联，并标记为候选项。

属于 Pipeworx —— 一个将 AI Agent 连接到 1745+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无隶属关系、未获其认可，也非由其发布。

工具

• ua_spend_payments(recipient_edrpou?, payer_edrpou?, date_from?, date_to?, purpose_contains?, limit?)：在最长 92 天的时间范围内，查询支付给和/或来自指定 EDRPOU 代码的所有财政部付款。返回总额、主要付款方和收款方，以及最新记录（日期、金额（UAH）、双方、用途文本、预算和 KEKV 代码，以及记录中包含的合同编号）。
• ua_spend_between(payer_edrpou, recipient_edrpou, date_from?, date_to?, limit?)：查询单个付款方支付给单个收款方的款项。返回 found（true/false）、笔数、总额、按月汇总以及记录。若 found:false，则附带 data_as_of 和说明，指出开放门户会隐去部分付款方。
• ua_spend_prozorro_link(supplier_edrpou, date_from?, date_to?, max_payers?)：查询供应商收到的财政部款项，以及其主要付款方作为买方、该供应商参与的 ProZorro 招标。每项关联均标记为 candidate，因为交易双方相同并不能证明某笔付款对应哪份合同。

身份验证

无需密钥。

数据源

• https://api.spending.gov.ua/api/v2/api/transactions/：乌克兰国家财政部（ДКСУ）的付款交易数据，也是 spending.gov.ua 背后的 API。
• https://prozorro.gov.ua/api/search/tenders（POST）：ProZorro 的公开招标搜索索引，供 ua_spend_prozorro_link 使用。

2026-10-08 实时测得的情况：

• payers_edrpous / recipt_edrpous 接受逗号分隔的代码；至少需要提供其中一个，同时提供两者时会按 AND 条件查询。
• 超过 92 天的时间范围会返回附有乌克兰语消息的 400 错误。日期格式必须为 YYYY-MM-DD。
• 数据通常比当天晚约 2 天。
• 对个人的付款，其收款方代码会被财政部隐去并替换为 xxxxxxxxxx，用途文本中的数字也会被替换为 xxxx。
• 部分付款方（例如国防部，00034022）在确定有付款的时间范围内也会返回空列表。应将空列表视为“未公开”，而非“没有付款”。
• Cloudflare Worker 冷启动后的首次 HTTPS 请求可能会从源站收到 525 错误。该包会重试一次，然后回退到普通 HTTP。
• ProZorro 的搜索记录包含买方名称，但从不包含其 EDRPOU，因此关联工具会针对每个付款方同时使用 tenderer + buyer 查询，而不是比较代码。单独使用 tenderer 筛选条件时结果较模糊。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "ukraine-public-spending": {
      "url": "https://gateway.pipeworx.io/ukraine-public-spending/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ukraine-public-spending/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其余工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天准确情况的权威依据。

这是有意为之，并非意外复用。元工具让受限连接也能回答此工具包未涵盖的问题——通过可在整个目录中路由请求的 ask_pipeworx——而无需添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文超出路由功能带来的价值，请改为连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都指向同一个网关和相同的 1745+ 个数据源。唯一的区别在于，哪些工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/ua_spend_payments \
  -H 'Content-Type: application/json' \
  -d '{"recipient_edrpou":"34315660","date_from":"2026-08-01","date_to":"2026-08-31","limit":10}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/ua_spend_payments。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需与网关往返通信：

{
  "mcpServers": {
    "ukraine-public-spending": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ukraine-public-spending"]
    }
  }
}

也可以直接运行，以确认它能启动：

npx -y @pipeworx/mcp-ukraine-public-spending

它通过 stdin/stdout 使用 MCP 协议，并且只会针对本工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

无需直接调用工具，你也可以用自然语言提问——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ukraine Public Spending data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT