Idb

@pipeworx/idb

美洲开发银行（IDB）项目采购——实时招标通知、中标合同，以及 5 家多边开发银行的交叉禁入查询，所有数据均来自 IDB 无需密钥的 CKAN 开放数据门户。

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

工具

• idb_search_notices(...) — 搜索 IDB 实时采购通知（招标、意向书、一般／具体通知、中标通知），覆盖 26 个拉美和加勒比国家；默认仅显示开放（截止日期尚未到）通知。
• idb_get_notice(notice_id) — 获取单条通知的完整记录。
• idb_search_awards(...) — 按国家、企业、行业或年份搜索约 159k 个已授予的 IDB 项目合同。
• idb_check_mdb_debarment(name, ...) — 查询名称是否出现在 IDB 自身的禁入名单，以及世界银行集团、亚洲开发银行、非洲开发银行和欧洲复兴开发银行的交叉禁入名单中（一个共享数据源即可查询五家银行的“此供应商是否被禁入”）。

身份验证

无需密钥。

数据源

• https://data.iadb.org/dataset/project-procurement-bidding-notices-and-notification-of-contract-awards — 招标通知 + 中标通知（约 37,000 行）。
• https://data.iadb.org/dataset/idb-project-procurement-contract-awards-data — 合同中标详情（约 159,000 行；数据集页面提供约 70MB 的 CSV，但相同数据也可通过 CKAN Datastore 获取，因此这里的每个工具都会使用服务器端 SQL 实时查询，而不是下载文件）。
• https://data.iadb.org/dataset/dataset-of-sanctioned-firms-and-individuals — IDB 禁入名单 + 世界银行集团／亚洲开发银行／非洲开发银行／欧洲复兴开发银行交叉禁入名单（约 1,300 行）。

这三个数据集均通过 data.iadb.org/api/3/action/datastore_search_sql 查询（CKAN Datastore，无需密钥，也无需身份验证）。维护此工具包时请注意：

• 此处的每个资源都已启用 CKAN Datastore — 对每个数据集调用 package_show 都会返回 datastore_active: true，因此可以进行实时 SQL 查询，无需下载并缓存 70MB 的中标数据文件。不要假定新的 IDB 数据集需要下载；请先检查 datastore_active。
• 普通的 /files/download/<id> URL 位于 AWS WAF 机器人验证之后（直接请求时会返回 HTTP 202 和 x-amzn-waf-action: challenge）——此处与此无关，因为没有任何工具会调用这些 URL；扩展此工具包时也不要使用它们，Datastore API 不受影响。
• 上游自带的全文搜索（datastore_search 中的 q=）会区分重音符号。 对一个充满 “González”（带重音符号）的禁入表使用 q=Gonzalez（不带重音符号）会返回零行——已通过实时查询验证。idb_check_mdb_debarment 从不使用 q=；它会获取整个（规模较小、约 1,300 行的）禁入表，并在客户端进行匹配，使用 NFD 规范化、去除变音符号和令牌子串比较。
• 通知表中的 type 带有不一致的尾随空格——SELECT DISTINCT "type" 会将 "AWARD"、"AWARD " 和 "AWARD " 返回为三个不同值。比较前务必使用 TRIM()，并使用前缀 ILIKE 进行匹配，切勿使用 =。
• datastore_search_sql 不支持绑定参数——插入字符串参数前，必须对每个参数进行引号转义（' → ''）。CKAN 的 SQL 端点本身仅接受针对只读副本的 SELECT 语句。
• idb-project-procurement-contract-awards-data 中有许多记录的 awarded_firm_name 为 "Not Available"——这是个人顾问选聘（contract_type: "Individual Consultants"）的预期情况，并非数据缺失。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/idb/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 都连接到同一个网关和相同的 1881+ 个数据源。唯一的区别是直接列出哪个工具包的工具；通过任一端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/idb_search_notices \
  -H 'Content-Type: application/json' \
  -d '{"country":"Peru","open_only":true,"limit":5}'

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

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

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

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

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

npx -y @pipeworx/mcp-idb

它通过 stdin/stdout 使用 MCP 通信，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。数据源相同、工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Idb data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT