CNBS MCP 서버

중국 국가통계국(NBS) 데이터 및 주요 국제 통계 데이터베이스를 조회하기 위한 MCP 서버입니다. 모든 데이터는 실제 API에서 가져오며, 모의 데이터는 사용하지 않습니다.

데이터 소스

소스	인증	범위
중국 NBS (data.stats.gov.cn)	없음	월별 / 분기별 / 연도별 / 성(省)별 국내 데이터
세계은행 (api.worldbank.org)	없음	200개 이상 국가 — GDP, CPI, 무역, 인구, FDI, 지니계수 등
IMF DataMapper	없음	WEO 전망 — GDP 성장률, 인플레이션, 정부 부채, 경상수지
OECD SDMX	없음	회원국 분기별 GDP, 고용, 선행 지표
BIS 통계	없음	실질 환율, 신용 격차, 부동산 가격, 국가 간 은행 업무
FRED (연방준비제도)	`X-Fred-Api-Key` 요청 헤더	미국 금리, CNY/USD, 원유, 금, S&P 500, M2
NBS 인구조사	없음	인구(2020), 경제(2018), 농업(2016) 조사
NBS 부서	없음	재정, 산업, 무역, 농업, 인민은행 통화, 사회보장, 주택, 에너지

FRED API 키: https://fred.stlouisfed.org/docs/api/api_key.html 에서 무료 등록 X-Fred-Api-Key 요청 헤더(HTTP 모드)로 전달하거나 FRED_API_KEY 환경 변수(stdio 모드)를 설정하세요.

Related MCP server: Stock Data MCP Server

설치

npx (권장)

npx mcp-cnbs

HTTP 전송

npx mcp-cnbs --port 12345

전역 설치

npm install -g mcp-cnbs
mcp-cnbs

MCP 클라이언트 설정

stdio 모드 (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"
 }
 }
 }
}

Alibaba Cloud ModelScope에서 제공하는 무료 공개 데모입니다. 인증이 필요하지 않습니다. 프로덕션 환경에서 사용하려면 직접 인스턴스를 배포하세요.

HTTP 엔드포인트

엔드포인트	메서드	설명
`/` 또는 `/mcp`	POST	스트리밍 가능한 HTTP — 세션 초기화 또는 요청 전송
`/` 또는 `/mcp`	GET	SSE 알림 스트림 (`Mcp-Session-Id` 헤더 필요)
`/` 또는 `/mcp`	DELETE	세션 종료 (`Mcp-Session-Id` 헤더 필요)
`/sse`	GET	레거시 SSE 모드
`/message`	POST	레거시 SSE 메시지

도구

NBS 핵심 쿼리

도구	설명
`cnbs_search`	키워드로 검색, 최신 값 반환 — 여기서 시작하세요
`cnbs_batch_search`	한 번의 호출로 여러 키워드 배치 검색
`cnbs_economic_snapshot`	10가지 주요 중국 거시경제 지표(GDP, CPI, PPI, PMI, 실업률, 산업 생산, 소매 판매, 고정 자산 투자, 무역, M2)의 원샷 스냅샷
`cnbs_compare`	지역 또는 기간별 데이터 비교
`cnbs_fetch_nodes`	카테고리 트리 노드 가져오기 — 하나 또는 여러 카테고리 허용
`cnbs_fetch_metrics`	지표 목록 가져오기 — 하나 또는 여러 `setIds` 허용
`cnbs_fetch_series`	시계열 데이터 가져오기
`cnbs_fetch_end_nodes`	모든 리프 노드를 재귀적으로 가져오기

NBS 참조

도구	설명
`cnbs_get_guide`	전체 도구 가이드 (LLM이 스스로 방향을 잡는 데 유용)
`cnbs_get_regions`	지역 코드 및 이름 (GB/T 2260)
`cnbs_get_categories`	NBS 카테고리 코드
`cnbs_list_data_sources`	도구 매핑이 포함된 모든 사용 가능한 데이터 소스
`cnbs_fetch_data_from_source`	명명된 소스에서 데이터 가져오기
`cnbs_get_source_categories`	특정 소스에 대한 카테고리
`cnbs_search_in_source`	특정 소스 내 검색

세계은행

도구	설명
`ext_world_bank`	국가 및 연도별 단일 지표 쿼리
`ext_world_bank_multi`	여러 지표를 한 번에 쿼리
`ext_world_bank_indicators`	지원되는 모든 세계은행 지표 목록

IMF

도구	설명
`ext_imf`	IMF WEO 데이터 쿼리 — 하나 또는 여러 지표 허용
`ext_imf_indicators`	지원되는 IMF 지표 목록
`ext_imf_all_indicators`	전체 IMF DataMapper 지표 카탈로그

OECD

도구	설명
`ext_oecd`	데이터셋 및 키별 OECD SDMX 데이터 쿼리
`ext_oecd_datasets`	지원되는 OECD 데이터셋 목록

BIS

도구	설명
`ext_bis`	BIS 통계 쿼리 — 하나 또는 여러 국가 허용
`ext_bis_datasets`	키 템플릿이 포함된 지원되는 BIS 데이터셋 목록

FRED (연방준비제도)

도구	설명
`ext_fred`	FRED 시리즈 쿼리 — 하나 또는 여러 시리즈 허용
`ext_fred_series`	지원되는 모든 FRED 시리즈 목록

중국 확장 소스

도구	설명
`ext_cn_census`	NBS 인구조사 데이터 (인구, 경제, 농업)
`ext_cn_department`	부처별 NBS 부서 통계
`ext_cn_department_list`	모든 부서 카테고리 및 지표 키워드

교차 소스 비교

도구	설명
`ext_global_compare`	국가별 동일 지표에 대해 세계은행 + IMF 동시 쿼리

빠른 예제

중국 경제 한눈에 보기

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

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)

NBS 카테고리 코드

코드	카테고리	주요 지표
1	월별	CPI, PPI, 산업 생산, PMI
2	분기별	GDP 분기별 성장률
3	연도별	GDP, 인구, 도시화율
5	성(省)별 분기	성별 분기 GDP
6	성(省)별 연도	성별 연도 GDP, 인구
7	기타 / 조사	가계 조사, 특별 조사

NBS 시간 형식

연도별: 2024YY, 범위 ["2020YY-2024YY"]
분기별: 2024A/B/C/D (A=1분기, B=2분기, C=3분기, D=4분기), 단축키 LAST6/LAST12/LAST18
월별: 202401MM, 범위 ["202301MM-202412MM"]

NBS 지역 코드

GB/T 2260 표준을 따릅니다. 전체 목록은 cnbs_get_regions를 사용하세요.

지역	코드
전국	`000000000000`
베이징	`110000000000`
상하이	`310000000000`
광둥	`440000000000`
저장	`330000000000`
장쑤	`320000000000`

인증

기본적으로 인증이 필요하지 않습니다. Bearer 토큰 인증을 활성화하려면:

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 Workers

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에 대한 네트워크 액세스

라이선스

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Appeared in Searches

A server for finding macroeconomic data

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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

URL: https://glama.ai/mcp/servers/icen-ai/mcp-cnbs?locale=ko-KR

⇱ CNBS MCP 서버 by icen-ai | Glama