CNBS MCP Server

CNBS MCP服务器

MCP服务器，用于查询中国国家统计局（NBS）数据和主要国际统计数据库。所有数据都是从真实的API中获取的，没有模拟数据。

数据源

FRED API密钥： 免费注册https://fred.stlouisfed.org/docs/api/api_key.html\ 将其作为 X-Fred-Api-Key 请求标头（HTTP模式）或设置 FRED_API_KEY 一个是（stdio模式）。

______________________________________________________________________

安装

npx（推荐）

npx mcp-cnbs

HTTP传输

npx mcp-cnbs --port 12345

全局安装

npm install -g mcp-cnbs
mcp-cnbs

______________________________________________________________________

MCP客户端配置

标准输入输出模式（npx）

支持的客户端： Claude Desktop、Cursor、Windsurf、Cherry Studio、Trae、Continue以及所有兼容MCP的客户端。

{
  "mcpServers": {
    "cnbs": {
      "command": "npx",
      "args": ["mcp-cnbs"]
    }
  }
}

在FRED支持下：

{
  "mcpServers": {
    "cnbs": {
      "command": "npx",
      "args": ["mcp-cnbs"],
      "env": {
        "FRED_API_KEY": "your_fred_api_key"
      }
    }
  }
}

HTTP模式（远程）

支持的客户端： Trae、Cherry Studio和其他支持HTTP传输的客户端。

ModelScope上的免费演示（无FRED）：

{
  "mcpServers": {
    "cnbs": {
      "url": "https://mcp.api-inference.modelscope.net/c2ca6ece4e9946/mcp"
    }
  }
}

带FRED的HTTP模式：

{
  "mcpServers": {
    "cnbs": {
      "url": "https://your-cnbs-server/mcp",
      "headers": {
        "X-Fred-Api-Key": "your_fred_api_key"
      }
    }
  }
}

阿里云ModelScope免费公开演示。无需身份验证。\ 对于生产用途， 部署您自己的实例.

______________________________________________________________________

HTTP端点

______________________________________________________________________

工具

NBS核心查询

NBS参考

世界银行

国际货币基金组织

经济合作与发展组织

国际清算银行

FRED（美联储）

中国延伸资源

跨源比较

______________________________________________________________________

快速示例

中国经济概览

// Full macro snapshot in one call
cnbs_economic_snapshot()

// Latest single indicator
cnbs_search(keyword="GDP")

// Batch indicators
cnbs_batch_search(keywords=["GDP", "CPI", "城镇化率", "出生率"])

// Regional comparison
cnbs_compare(keyword="GDP", regions=["北京", "上海", "广东"], compareType="region")

// Time series
cnbs_fetch_series(setId="...", metricIds=["..."], periods=["2015YY-2024YY"])

国际比较

// China GDP growth vs peers (World Bank)
ext_world_bank(indicator="GDP_GROWTH", countries=["CHN","USA","DEU","JPN","IND"], startYear=2015)

// Multiple indicators for China
ext_world_bank_multi(indicators=["GDP_GROWTH","CPI","UNEMPLOYMENT"], countries=["CHN"], startYear=2010)

// IMF: single indicator
ext_imf(indicators="GDP_GROWTH", countries=["CHN","USA","JPN"], periods=["2022","2023","2024","2025"])

// IMF: multiple indicators in one call
ext_imf(indicators=["GDP_GROWTH","CPI_INFLATION","GOVT_DEBT"], countries=["CHN","USA"], periods=["2020","2021","2022","2023","2024"])

// World Bank + IMF side-by-side
ext_global_compare(wbIndicator="GDP_GROWTH", imfIndicator="GDP_GROWTH", countries=["CHN","USA","DEU","JPN"])

BIS&弗雷德

// BIS: single country
ext_bis(dataset="EER", countries="CN", lastNObservations=36)

// BIS: multiple countries in one call
ext_bis(dataset="EER", countries=["CN","US","DE","JP"], lastNObservations=24)

// BIS: credit gap
ext_bis(dataset="CREDIT_GAP", countries=["CN","US"], lastNObservations=20)

// FRED: single series
ext_fred(series="OIL_PRICE_WTI", limit=100, sortOrder="desc")

// FRED: multiple series in one call
ext_fred(series=["FED_FUNDS","CNY_USD","OIL_PRICE_WTI","GOLD_PRICE"], limit=30, sortOrder="desc")

国家统计局人口普查和部门

// 2020 Population census
ext_cn_census(type="population")

// PBoC M2 monetary data
ext_cn_department(department="monetary", indicator="M2货币供应量")

// All finance ministry indicators
ext_cn_department(department="finance", fetchAll=true)

______________________________________________________________________

NBS类别代码

NBS时间格式

• 年度： 2024YY，范围 ["2020YY-2024YY"]
• 季度： 2024A/B/C/D （A=Q1，B=Q2，C=Q3，D=Q4），快捷键 LAST6/LAST12/LAST18
• 每月： 202401MM，范围 ["202301MM-202412MM"]

NBS地区代码

遵循GB/T 2260标准。使用 cnbs_get_regions 查看完整列表。

______________________________________________________________________

认证

默认情况下不需要身份验证。启用承载令牌身份验证：

stdio/HTTP模式

npx mcp-cnbs --port 12345 --auth-token your-secret-token
# or via env var
MCP_CNBS_AUTH_TOKEN=your-secret-token npx mcp-cnbs --port 12345

然后，请求必须包括：

Authorization: Bearer your-secret-token

Cloudflare员工

npx wrangler secret put MCP_CNBS_AUTH_TOKEN

______________________________________________________________________

发展

npm install
npm run build
npm run start

需求

• Node.js>=18.0.0
• 网络访问 data.stats.gov.cn, api.worldbank.org, www.imf.org, sdmx.oecd.org, stats.bis.org, api.stlouisfed.org

许可证

麻省理工学院