Cia Factbook

@pipeworx/cia-factbook

CIA《世界概况》国家简介（2026 年最终版），涵盖 261 个实体，包含历史、地理、人口、政府、经济、能源、军事和跨国议题，并支持并排比较不同国家的字段。

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

工具

• factbook_country(country, sections?)：查询单个实体的简介。默认返回简介、地理、人口与社会、政府和经济；sections 可指定其他部分，或设为 ["all"] 获取全部内容（约 35 KB）。可回答“介绍一下肯尼亚”或“智利实行什么政体”等问题。
• factbook_compare(countries, fields)：并排比较最多 10 个国家 × 10 个字段，例如人口、人均实际 GDP、出生时预期寿命。字段名称与《世界概况》的标题一致（不区分大小写，支持部分匹配）；"Economy > Exports" 可指定具体部分。
• factbook_fields(country?)：列出简介包含的部分和字段名称。可用于查找 factbook_compare 所需的确切字段名称。
• factbook_entities(query?, region?, limit?)：列出或搜索这 261 个实体（国家、地区、海洋、欧盟、世界），并显示其《世界概况》代码和地区。

country 可接受名称（“South Korea”、“Myanmar”、“Ivory Coast”）、ISO 3166 代码（“KE”、“DEU”），或以 gec:<code> 格式书写的《世界概况》代码。如果名称没有匹配项，工具会返回 found:false，并列出最接近的匹配项。

每条响应都包含 source、licence、data_as_of 和 edition_note。

身份验证

无需密钥。

数据来源

• 美国中央情报局（CIA），《世界概况》。CIA 将其作为公有领域内容发布，并于 2026 年 2 月停止更新。本工具包读取《世界概况》项目维护的开放 JSON 档案中的最终版本，该档案采用 CC0-1.0 许可。本工具包每次请求时都会调用该档案，不会存储副本。

需要了解的事项：

• 数据已冻结。 档案最后一次更新数据的日期为 2026-01-22，《世界概况》不会再更新，因此 data_as_of 始终为 2026-01-22。每个数据都带有自己的估算年份，例如“55,751,717（2025 年估算）”。
• 《世界概况》代码不是 ISO 代码。 在 GEC 代码中，au 代表奥地利，gm 代表德国。本工具包会优先将纯 2 位或 3 位字母输入视为 ISO 代码，只有在没有匹配的 ISO 国家时才将其视为 GEC 代码。使用 gec:au 可强制指定《世界概况》代码。
• 《世界概况》采用自己的拼写。 其中使用“Burma”、“Turkey”、“DRC”、“Congo (Brazzaville)”、“Côte d'Ivoire”和“The Gambia”。本工具包会将常见的其他名称映射为这些名称。
• 部分简介包含的部分比其他简介少。海洋没有“人口与社会”部分，一些地区没有“军事”部分。other_sections 和 factbook_fields 会显示指定简介包含哪些内容。

快速开始

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

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

此端点实际提供的内容

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

这是有意设计的，并非意外复用。元工具可以让受限连接通过 ask_pipeworx 回答该工具包未涵盖的问题；ask_pipeworx 会在整个目录中进行路由，因此你无需再添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文比路由带来的收益还多，请只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/factbook_country \
  -H 'Content-Type: application/json' \
  -d '{"country":"Kenya"}'

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

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

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

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

或者，直接运行以确认其能正常启动：

npx -y @pipeworx/mcp-cia-factbook

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Cia Factbook data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT