关于 Worldbank
Worldbank 将世界银行开放数据 API 中的发展、经济、社会和人口指标提供给研究人员、分析者及 AI Agent。它支持跨国和时间序列查询,并包含六项全球治理指标;数据公开免费,但覆盖和更新时滞因指标而异。
主要功能
- 01搜索数千种发展与经济指标
- 02查询国家及国家组的时间序列
- 03比较多国同一指标
- 04获取六项全球治理指标
适用场景
- 01比较不同国家的人均 GDP 或贫困指标
- 02追踪教育、健康或环境数据变化
- 03查看单个国家的治理指标趋势
MCP 相关
通过 MCP 工具访问世界银行开放数据,可连接 Pipeworx 网关,或作为本地 stdio MCP 服务运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/worldbank/mcpclaude mcp add --transport http pipeworx-io-worldbank https://gateway.pipeworx.io/worldbank/mcp{"mcpServers":{"pipeworx-io-worldbank":{"type":"http","url":"https://gateway.pipeworx.io/worldbank/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-worldbank":{"type":"http","url":"https://gateway.pipeworx.io/worldbank/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-worldbank":{"type":"http","url":"https://gateway.pipeworx.io/worldbank/mcp"}}}{"mcpServers":{"pipeworx-io-worldbank":{"serverUrl":"https://gateway.pipeworx.io/worldbank/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
世界银行 — 发展指标与国家数据
世界银行开放数据 API。涵盖每个国家数千项发展、经济、社会和人口指标。时间序列可追溯数十年。是跨国比较贫困、教育、健康、性别、环境和基础设施的权威数据源。免费,无需身份验证。
这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1831+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成,与上游提供方无关联,未获其认可,也非由其发布。
为什么这对 AI Agent 很重要
对于发展相关问题、社会指标的跨国比较,或任何“X 国在 Y 指标上表现如何”的问题,世界银行数据库都是合适的起点。它与 IMF(宏观经济/财政)形成互补,涵盖发展领域的专门数据(WDI、EdStats、GenderStats 等)。
常见工作流:
- 查询指标。“印度的人均 GDP(PPP)” → 印度的世界银行指标
NY.GDP.PCAP.PP.CD。 - **国家比较。**比较多个国家的同一指标。
- **浏览主题。**教育指标、健康指标、环境指标等。
身份验证
无需身份验证。世界银行开放数据完全公开且免费。
指标代码结构
世界银行指标代码遵循“领域.主题.度量”的格式:
| 代码 | 指标 |
|---|---|
NY.GDP.MKTP.CD | GDP(现价美元) |
NY.GDP.PCAP.PP.CD | 人均 GDP,PPP(现价国际元) |
SP.POP.TOTL | 总人口 |
SE.PRM.ENRR | 小学入学率,总入学率(%) |
EG.ELC.ACCS.ZS | 用电人口占比(%) |
SI.POV.GINI | 基尼指数 |
EN.ATM.CO2E.PC | 人均 CO2 排放量 |
如果不知道代码,请搜索目录。
国家和国家组代码
世界银行使用 ISO 3 字母代码(USA、BRA、IND)以及汇总代码:
WLD— 世界EUU— 欧盟LMC— 中低收入OED— OECD 成员SSA— 撒哈拉以南非洲
对于“X 与其同类群体相比如何?”这类问题,汇总代码很有用。
全球治理指标(WGI)
世界银行还发布全球治理指标——每个国家在六个治理质量维度上的指标,可与事件/新闻数据结合,用作国家风险背景:发声与问责、政治稳定与免于暴力/恐怖主义、政府效能、监管质量、法治和腐败控制。这些指标存放在与上述常规发展指标不同的世界银行源数据库中,代码如 GOV_WGI_CC.EST(腐败控制,治理估值)和 GOV_WGI_CC.SC(同一维度,0–100 百分位分数)——可通过此工具包现有的 get_indicator / compare_countries 工具查询,但如果不知道代码便无法猜出,因此可使用专用的 get_governance_indicators 工具,获取单个国家六个维度的完整快照(最新年份 + 前一年),用于观察趋势。
| 维度 | .EST 代码 |
|---|---|
| 发声与问责 | GOV_WGI_VA.EST |
| 政治稳定与免于暴力/恐怖主义 | GOV_WGI_PV.EST |
| 政府效能 | GOV_WGI_GE.EST |
| 监管质量 | GOV_WGI_RQ.EST |
| 法治 | GOV_WGI_RL.EST |
| 腐败控制 | GOV_WGI_CC.EST |
每项 .EST 估值的范围约为 -2.5(最弱)至 +2.5(最强);对应的 .SC 代码是 0–100 的百分位分数,数值越高,表示该国相对于当年获得评分的其他国家治理水平越强。
常见陷阱
- 指标弃用。 世界银行会定期停用或替换指标。API 会标记已弃用的指标;开展新分析时应优先使用当前指标。
- 数据覆盖缺口。 并非每个国家每年都会报告所有指标。API 会对缺失数据返回 null。计算汇总数据时请务必谨慎。
- 数据版本。 指标值可能会修订。如果精度很重要,请注明所用数据版本。
- 实际值与名义值。 许多金融指标同时提供名义值(当期美元)和实际值(不变美元)。
.CD后缀表示当期美元;.KD表示不变美元。 - 购买力平价与市场汇率。 对于大多数“X 有多富裕”这类问题,跨国比较 GDP 应使用购买力平价;对于“X 出口什么”这类问题,则应使用市场汇率。
- 数据时效性。 世界银行汇总成员国报告的数据;数据滞后时间各不相同。许多指标的最新年份比当前年份早 1–2 年。承诺提供“当前”数据前,请先检查数据可用性。
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"worldbank": {
"url": "https://gateway.pipeworx.io/worldbank/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/worldbank/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 都连接到同一个网关和相同的 1831+ 个数据源。唯一的区别在于哪些工具包的工具会被直接列出;无论连接哪个端点,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/worldbank_get_country \
-H 'Content-Type: application/json' \
-d '{"country_code":"US"}'
首次调用无需账户。查看任意工具:GET https://gateway.pipeworx.io/v1/tools/worldbank_get_country。查找工具:使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需往返网关:
{
"mcpServers": {
"worldbank": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-worldbank"]
}
}
}
或者直接运行以确认它能启动:
npx -y @pipeworx/mcp-worldbank
它通过 stdin/stdout 使用 MCP,并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。数据源相同,工具相同,但没有 ask_pipeworx 路由功能。
使用 ask_pipeworx
你也可以用通俗英语提问,而不是直接调用工具——此方式既适用于上文的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Worldbank data" })
网关会选择合适的工具并自动填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。