VOOZH about

URL: https://glama.ai/mcp/servers/icen-ai/mcp-cnbs?locale=es-ES

⇱ Servidor MCP de CNBS by icen-ai | Glama


Servidor MCP de CNBS

Servidor MCP para consultar datos de la Oficina Nacional de Estadística (NBS) de China y las principales bases de datos estadísticas internacionales. Todos los datos se obtienen de APIs reales; no se utilizan datos simulados.

Fuentes de datos

Fuente

Autenticación

Cobertura

China NBS (data.stats.gov.cn)

Ninguna

Datos nacionales mensuales / trimestrales / anuales / provinciales

Banco Mundial (api.worldbank.org)

Ninguna

Más de 200 países: PIB, IPC, comercio, población, IED, Gini, etc.

IMF DataMapper

Ninguna

Previsiones WEO: crecimiento del PIB, inflación, deuda pública, cuenta corriente

OECD SDMX

Ninguna

PIB trimestral de países miembros, empleo, indicadores adelantados

BIS Statistics

Ninguna

Tipos de cambio efectivos, brechas de crédito, precios inmobiliarios, banca transfronteriza

FRED (Reserva Federal)

Cabecera de solicitud X-Fred-Api-Key

Tipos de interés en EE. UU., CNY/USD, petróleo, oro, S&P 500, M2

Censo NBS

Ninguna

Censos de población (2020), económicos (2018), agrícolas (2016)

Departamentos NBS

Ninguna

Finanzas, industria, comercio, agricultura, política monetaria del PBoC, seguridad social, vivienda, energía

Clave API de FRED: Registro gratuito en https://fred.stlouisfed.org/docs/api/api\\\\_key.html\\\\ Pásela como la cabecera de solicitud X-Fred-Api-Key (modo HTTP) o establezca la variable de entorno FRED_API_KEY (modo stdio).


Related MCP server: Stock Data MCP Server

Instalación

npx (Recomendado)

npx mcp-cnbs

Transporte HTTP

npx mcp-cnbs --port 12345

Instalación global

npm install -g mcp-cnbs
mcp-cnbs

Configuración del cliente MCP

Modo stdio (npx)

Clientes compatibles: Claude Desktop, Cursor, Windsurf, Cherry Studio, Trae, Continue y todos los clientes compatibles con MCP.

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

Con soporte para FRED:

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

Modo HTTP (remoto)

Clientes compatibles: Trae, Cherry Studio y otros clientes con soporte para transporte HTTP.

Demo gratuita en ModelScope (sin FRED):

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

Modo HTTP con FRED:

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

Demo pública gratuita de Alibaba Cloud ModelScope. No requiere autenticación.
Para uso en producción, despliegue su propia instancia.


Endpoints HTTP

Endpoint

Método

Descripción

/ o /mcp

POST

HTTP con streaming: inicializar sesión o enviar solicitudes

/ o /mcp

GET

Flujo de notificaciones SSE (requiere cabecera Mcp-Session-Id)

/ o /mcp

DELETE

Terminar sesión (requiere cabecera Mcp-Session-Id)

/sse

GET

Modo SSE heredado

/message

POST

Mensajes SSE heredados


Herramientas

Consulta principal de NBS

Herramienta

Descripción

cnbs_search

Buscar por palabra clave, devuelve el valor más reciente: empiece aquí

cnbs_batch_search

Búsqueda por lotes de múltiples palabras clave en una sola llamada

cnbs_economic_snapshot

Instantánea única de 10 indicadores macroeconómicos clave de China (PIB, IPC, IPP, PMI, desempleo, producción industrial, ventas minoristas, inversión fija, comercio, M2)

cnbs_compare

Comparar datos entre regiones o periodos de tiempo

cnbs_fetch_nodes

Obtener nodos del árbol de categorías: acepta una o varias categorías

cnbs_fetch_metrics

Obtener lista de indicadores: acepta uno o varios setIds

cnbs_fetch_series

Obtener datos de series temporales

cnbs_fetch_end_nodes

Obtener recursivamente todos los nodos hoja

Referencia de NBS

Herramienta

Descripción

cnbs_get_guide

Guía completa de herramientas (útil para que los LLM se orienten)

cnbs_get_regions

Códigos y nombres de regiones (GB/T 2260)

cnbs_get_categories

Códigos de categoría de NBS

cnbs_list_data_sources

Todas las fuentes de datos disponibles con mapeos de herramientas

cnbs_fetch_data_from_source

Obtener datos de cualquier fuente nombrada

cnbs_get_source_categories

Categorías para una fuente determinada

cnbs_search_in_source

Buscar dentro de una fuente específica

Banco Mundial

Herramienta

Descripción

ext_world_bank

Consultar un solo indicador entre países y años

ext_world_bank_multi

Consultar múltiples indicadores a la vez

ext_world_bank_indicators

Listar todos los indicadores compatibles del Banco Mundial

FMI

Herramienta

Descripción

ext_imf

Consultar datos WEO del FMI: acepta uno o varios indicadores

ext_imf_indicators

Listar indicadores compatibles del FMI

ext_imf_all_indicators

Catálogo completo de indicadores de IMF DataMapper

OCDE

Herramienta

Descripción

ext_oecd

Consultar datos SDMX de la OCDE por conjunto de datos y clave

ext_oecd_datasets

Listar conjuntos de datos compatibles de la OCDE

BIS

Herramienta

Descripción

ext_bis

Consultar estadísticas del BIS: acepta uno o varios países

ext_bis_datasets

Listar conjuntos de datos compatibles del BIS con plantillas de clave

FRED (Reserva Federal)

Herramienta

Descripción

ext_fred

Consultar series de FRED: acepta una o varias series

ext_fred_series

Listar todas las series compatibles de FRED

Fuentes extendidas de China

Herramienta

Descripción

ext_cn_census

Datos del censo de NBS (población, economía, agricultura)

ext_cn_department

Estadísticas de departamentos de NBS por ministerio

ext_cn_department_list

Todas las categorías de departamentos y palabras clave de indicadores

Comparación entre fuentes

Herramienta

Descripción

ext_global_compare

Consultar simultáneamente el Banco Mundial + FMI para el mismo indicador entre países


Ejemplos rápidos

Panorama de la economía china

// 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"])

Comparación internacional

// 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 y FRED

// 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")

Censo y departamentos de NBS

// 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)

Códigos de categoría de NBS

Código

Categoría

Indicadores típicos

1

Mensual

IPC, IPP, Producción industrial, PMI

2

Trimestral

Crecimiento trimestral del PIB

3

Anual

PIB, población, tasa de urbanización

5

Trimestral provincial

PIB provincial por trimestre

6

Anual provincial

PIB provincial, población por año

7

Otros / Encuestas

Encuestas de hogares, encuestas especiales

Formato de tiempo de NBS

  • Anual: 2024YY, rango ["2020YY-2024YY"]

  • Trimestral: 2024A/B/C/D (A=T1, B=T2, C=T3, D=T4), atajos LAST6/LAST12/LAST18

  • Mensual: 202401MM, rango ["202301MM-202412MM"]

Códigos de región de NBS

Sigue el estándar GB/T 2260. Use cnbs_get_regions para la lista completa.

Región

Código

Nacional

000000000000

Pekín

110000000000

Shanghái

310000000000

Cantón

440000000000

Zhejiang

330000000000

Jiangsu

320000000000


Autenticación

No se requiere autenticación por defecto. Habilite la autenticación con token Bearer:

Modo 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

Las solicitudes deben incluir entonces:

Authorization: Bearer your-secret-token

Cloudflare Workers

npx wrangler secret put MCP_CNBS_AUTH_TOKEN

Desarrollo

npm install
npm run build
npm run start

Requisitos

  • Node.js >= 18.0.0

  • Acceso a la red a data.stats.gov.cn, api.worldbank.org, www.imf.org, sdmx.oecd.org, stats.bis.org, api.stlouisfed.org

Licencia

MIT

A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/icen-ai/mcp-cnbs'

If you have feedback or need assistance with the MCP directory API, please join our Discord server