How do I use ECOS MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ECOS MCP Server What's the recent trend in the base rate?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ECOS MCP Server

by kgy0617

Overview Schema Source Related Servers Discussions Admin

Python

Remote

🏦 ECOS MCP Server

한국은행 경제통계시스템(ECOS) Open API를 위한 최신 MCP(Model Context Protocol) 서버입니다.

AI 에이전트(Claude Desktop, Cursor 등)가 한국 거시경제 통계 데이터를 자연어로 실시간 검색하고 고효율 시계열 분석을 수행할 수 있게 해줍니다.

✨ 핵심 기능

🛠️ MCP Tools (7개)

모든 도구는 읽기 전용(readOnlyHint)으로 표시되어 있고, 실패 시 MCP 표준 에러(isError: true)를 반환합니다.

Tool	설명	주요 특징
`get_popular_statistic`	1-Shot 인기 지표 즉시 조회	기준금리, 성장률, 물가상승률, 환율 등을 코드 검색 없이 한 번의 호출로 조회
`search_statistics`	통계 시계열 데이터 조회 (핵심)	스마트 날짜, 최신 구간 우선, 증감률 계산(`transform`), 컴팩트/CSV 포맷
`search_statistic_tables`	통계표 검색·계층 탐색	로컬 인덱스로 즉시 응답. 띄어쓰기 무시·다중 단어·관련도 순 정렬, `parent_code`로 분류 트리 탐색
`get_key_statistics`	100대 주요 경제지표 조회	GDP, 기준금리, 환율, 통화량 등 실시간 핵심 지표
`search_statistic_word`	통계 용어 사전 검색	한국은행 공식 용어 해설
`list_statistic_items`	통계표 세부항목 목록 조회	항목코드, 지원 주기, 수록 기간, 단위 확인 (결과 캐시)
`get_statistic_meta`	통계 메타데이터 조회	통계 작성 배경, 작성 주기, 편제 기준 등 (결과 캐시)

⚡ 토큰 최적화 포맷 (`output_format`)

시계열 조회(search_statistics, get_popular_statistic) 결과는 공백 없는 JSON으로 반환됩니다.

"compact" (기본값): 계열(항목)별로 이름·단위를 한 번만 쓰고 값은 [시점, 값] 배열로 반환
"csv": 한 줄에 관측치 하나. 여러 항목을 표·차트로 옮길 때 편리
"json": ECOS 원본 행 그대로

측정 예시(소비자물가지수 24개월 단일 계열, 문자 수 기준): 원본 JSON 6,545자 → compact 605자(약 91% 축소), csv 805자.

📈 증감률·변경 시점 (`transform`, `changes_only`)

transform="yoy": 전년동기대비 증감률(%) 열(yoy_pct) 추가. 기준 시점 데이터는 자동으로 함께 조회합니다.
transform="pop": 직전 관측치 대비 증감률(%) 열(pop_pct) 추가
changes_only=True: 값이 바뀐 시점만 반환 (예: 일별 기준금리 2년치 약 500행 → 변경 시점 몇 행)

🗓️ 스마트 날짜 & 최신 구간 우선

start_date/end_date를 생략하면 일간(D)은 최근 3개월, 그 외 주기는 최근 2년이 자동 설정됩니다.
결과가 한 번에 다 담기지 않으면(end_count 초과, sample 키는 10건) 가장 최근 구간을 반환하고 truncated: true와 안내 문구를 붙입니다. 과거부터 페이지 단위로 받으려면 prefer_latest=False를 쓰세요.

Related MCP server: kosis-mcp

📚 MCP Resources & Prompts

Resources

ecos://popular-indicators: 한국은행 주요 핵심 경제지표(기준금리, 실질 GDP, 소비자물가지수, 환율, M2 등) 프리셋 매핑표
ecos://date-format-guide: 주기(Cycle)별 올바른 날짜 포맷 규격 안내서

Prompts

macro-economic-briefing: 100대 지표와 성장률·물가상승률·기준금리·환율 추이 기반 경제 현황 브리핑
analyze-economic-trend: 특정 경제 지표(소비자물가지수 등) 시계열 추이 및 정책 시사점 심층 분석

📅 주기(Cycle)별 날짜 포맷 규칙

주기 코드	주기명	시작/종료일 포맷 규격	예시
`A`	연간	`YYYY`	`"2020"`, `"2024"`
`S`	반기	`YYYYS1` / `YYYYS2`	`"2023S1"`, `"2023S2"`
`Q`	분기	`YYYYQ1` ~ `YYYYQ4`	`"2023Q1"`, `"2024Q3"`
`M`	월간	`YYYYMM`	`"202401"`, `"202412"`
`SM`	반월	`YYYYMMS1` / `YYYYMMS2`	`"202401S1"`, `"202401S2"`
`D`	일간	`YYYYMMDD`	`"20240101"`, `"20240315"`

📌 주요 인기 통계표 프리셋

지표명	키워드(별칭)	통계표코드	주기	항목코드	기본 처리
한국은행 기준금리	`기준금리`, `금리`, `base_rate`	`722Y001`	`D`	`0101000`	변경 시점만
경제성장률(실질, 전기비 %)	`성장률`, `경제성장률`, `GDP성장률`	`200Y102`	`Q`	`10111`
실질 GDP(분기, 십억원)	`GDP`, `실질GDP`, `국내총생산`	`200Y108`	`Q`	`10601`
소비자물가상승률(%)	`물가상승률`, `인플레이션`	`901Y009`	`M`	`0`	`yoy`
소비자물가지수(CPI)	`CPI`, `소비자물가`, `물가`	`901Y009`	`M`	`0`
원/달러 환율(일별)	`환율`, `원달러`, `달러`, `USD`	`731Y001`	`D`	`0000001`
원/달러 환율(월평균)	`월평균환율`, `usd_krw_monthly`	`731Y004`	`M`	`0000001`/`0000100`
본원통화(평잔)	`본원통화`, `reserve_money`	`102Y004`	`M`	`ABA1`
M2 광의통화	`M2`, `통화량`, `광의통화`	`161Y006`	`M`	`BBHA00`
국고채(3년) 수익률(일별)	`국고채`, `국고채3년`, `채권금리`	`817Y002`	`D`	`010200000`
국고채(3년) 수익률(월평균)	`국고채월평균`, `treasury_3y_monthly`	`721Y001`	`M`	`5020000`
생산자물가지수(PPI)	`PPI`, `생산자물가`	`404Y014`	`M`	`*AA`

"통화", "지수"처럼 여러 지표에 걸치는 키워드는 후보 목록을 담은 에러를 돌려주므로, 더 구체적인 키워드나 id를 쓰면 됩니다.

🚀 빠른 시작

1. 설치 (로컬 개발 시)

git clone https://github.com/kgy0617/ecos_mcp.git
cd ecos_mcp
uv sync

2. API 키 설정 (선택)

cp .env.example .env
# .env 파일에서 ECOS_API_KEY 입력 (미입력 시 sample 키 자동 적용)

💡 API 키 없이도 sample 키로 테스트 가능하며, 1회 최대 허용치(10건)로 자동 클램핑됩니다.

3. 자가 진단 헬스체크 실행

uv run ecos-mcp --check

네트워크 연결, API 키 상태, 통계표 인덱스 로드가 자동으로 진단됩니다.

🔧 MCP 클라이언트 설정

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

방법 A: GitHub URL 직접 실행 (클론 불필요, 추천 ⭐)

{
  "mcpServers": {
    "ecos": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kgy0617/ecos_mcp", "ecos-mcp"],
      "env": {
        "ECOS_API_KEY": "your_api_key_here"
      }
    }
  }
}

방법 B: 로컬 클론 실행

{
  "mcpServers": {
    "ecos": {
      "command": "uv",
      "args": ["--directory", "/path/to/ecos_mcp", "run", "ecos-mcp"],
      "env": {
        "ECOS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add ecos -e ECOS_API_KEY=your_api_key_here -- uvx --from git+https://github.com/kgy0617/ecos_mcp ecos-mcp

Cursor

Settings > Features > MCP Servers > Add New MCP Server:

방법 A (GitHub 직접 실행):
- Name: ecos
- Type: command
- Command: uvx --from git+https://github.com/kgy0617/ecos_mcp ecos-mcp
방법 B (로컬 클론):
- Name: ecos
- Type: command
- Command: uv --directory /path/to/ecos_mcp run ecos-mcp

📖 사용 예시

1. 인기 지표 원스톱 조회 (`get_popular_statistic`)

사용자: "최근 한국 기준금리 어떻게 바뀌었어?"

Tool 호출:

{
  "indicator": "기준금리",
  "recent_years": 2,
  "output_format": "compact"
}

응답 예시 (일별 500여 행 대신 changes_only=True가 기본 적용되어 금리 변동 시점만 간결하게 반환):

{
  "stat_code": "722Y001",
  "stat_name": "한국은행 기준금리 및 여수신금리",
  "indicator": "base_rate",
  "total_count": 500,
  "count": 3,
  "columns": ["time", "value"],
  "series": [
    {
      "item": "한국은행 기준금리",
      "item_code": "0101000",
      "unit": "연%",
      "data": [
        ["20230113", 3.5],
        ["20241011", 3.25],
        ["20241128", 3.0]
      ]
    }
  ]
}

2. 물가상승률 CSV 수신 후 차트 분석

사용자: "소비자물가 상승률 최근 데이터 CSV로 뽑아서 분석해줘"

Tool 호출:

{
  "indicator": "물가상승률",
  "recent_years": 1,
  "output_format": "csv"
}

응답 예시 (transform="yoy"가 자동 적용되어 전년동기대비 증감률 열인 YOY_PCT가 포함됨):

# stat_code: 901Y009
# stat_name: 4.2.1. 소비자물가지수
# indicator: inflation_rate
# total_count: 12
# count: 12
TIME,ITEM_CODE,ITEM,VALUE,UNIT,YOY_PCT
202401,0,총지수,113.15,2020=100,2.8
202402,0,총지수,113.77,2020=100,3.1
202403,0,총지수,113.94,2020=100,3.1
202404,0,총지수,114.09,2020=100,2.9
202405,0,총지수,114.14,2020=100,2.7
...

3. 통계표 키워드 검색 및 계층 탐색 (`search_statistic_tables`)

사용자: "소비자물가 관련 통계표 찾아줘"

Tool 호출:

{
  "keyword": "소비자 물가",
  "searchable_only": true,
  "limit": 3
}

응답 예시 (로컬 인덱스 기반으로 띄어쓰기 무시 및 관련도 순 정렬):

{
  "query": "소비자 물가",
  "total_matches": 3,
  "count": 2,
  "searchable_only": true,
  "index_generated_at": "2026-09-26",
  "rows": [
    {
      "P_STAT_CODE": "0000000211",
      "STAT_CODE": "901Y009",
      "STAT_NAME": "4.2.1. 소비자물가지수",
      "CYCLE": "M",
      "SRCH_YN": "Y",
      "ORG_NAME": "국가데이터처(02-2012-9114)"
    },
    {
      "P_STAT_CODE": "0000000211",
      "STAT_CODE": "901Y010",
      "STAT_NAME": "4.2.2. 소비자물가지수(특수분류)",
      "CYCLE": "M",
      "SRCH_YN": "Y",
      "ORG_NAME": "국가데이터처(02-2012-9114)"
    }
  ]
}

Tip: parent_code="0000000211"를 지정하면 해당 분류의 하위 통계표 트리를 직접 탐색할 수도 있습니다.

4. 통계 용어 사전 검색 (`search_statistic_word`)

사용자: "한국은행에서 정의하는 기준금리의 정확한 의미가 뭐야?"

Tool 호출:

{
  "word": "기준금리"
}

응답 예시:

{
  "total_count": 1,
  "count": 1,
  "rows": [
    {
      "WORD": "기준금리",
      "CONTENT": "한국은행이 금융기관과 환매조건부증권(RP) 매매, 자금조정 예금 및 대출 등의 거래를 할 때 기준이 되는 정책금리"
    }
  ]
}

🧪 테스트 실행

uv run pytest            # 오프라인 단위 테스트 (ECOS API를 모킹, 네트워크 불필요)
uv run pytest -m live    # 실제 ECOS API 호출 테스트 (모든 프리셋 조회 확인)

📝 라이선스

MIT License

Available Tools

7 tools

get_key_statistics100대 주요 경제지표A

Read-onlyIdempotent

100대 주요 경제지표를 조회합니다.

GDP 성장률, 기준금리, 소비자물가 상승률, 실업률, M1/M2 통화량 등
한국 경제의 핵심 지표를 한 번에 확인할 수 있습니다.

Args:
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 100, sample 키는 최대 10건으로 자동 제한)
    language: 응답 언어 — "kr"(한국어) 또는 "en"(영어)

Returns:
    주요 경제지표 목록

Inputs: language, end_count, start_count.

get_popular_statistic인기 경제지표 즉시 조회A

Read-onlyIdempotent

한국은행 핵심 경제지표를 코드 검색 없이 단 1번의 호출로 즉시 조회합니다.

사용자가 "기준금리 알려줘", "최근 성장률", "물가상승률 추이" 등을 물을 때
통계표코드나 항목코드를 검색할 필요 없이 즉각적으로 시계열 데이터를 반환합니다.

지원하는 지표 키워드:
- 기준금리 ("기준금리", "금리", "정책금리") — 변경 시점만 반환(changes_only 기본 True)
- 경제성장률 ("경제성장률", "성장률", "GDP성장률") — 실질 GDP 전기비 %
- 국내총생산 ("GDP", "실질GDP", "국내총생산") — 실질 GDP 수준(십억원)
- 소비자물가상승률 ("물가상승률", "인플레이션") — CPI 전년동월비 %(yoy_pct)
- 소비자물가지수 ("CPI", "소비자물가", "물가") — 지수 수준(2020=100)
- 원/달러 환율 ("환율", "원달러", "달러", "USD") — 일별 / ("월평균환율") — 월평균
- 본원통화 ("본원통화", "중앙은행부채")
- M2 광의통화 ("M2", "통화량", "광의통화")
- 국고채 3년 ("국고채", "국고채3년", "채권금리") — 일별 / ("국고채월평균") — 월평균
- 생산자물가지수 ("PPI", "생산자물가")

Args:
    indicator: 조회할 지표명 또는 키워드 (예: "기준금리", "물가상승률", "성장률", "환율")
    recent_years: start_date 미지정 시 최근 몇 년치를 조회할지 (기본: 일별 지표 최근 3개월, 그 외 2년)
    start_date: 검색 시작일 (주기에 맞는 포맷. 미입력 시 자동 계산)
    end_date: 검색 종료일 (미입력 시 현재 시점)
    output_format: "compact"(기본값, 계열별 [시점, 값] 배열), "csv", "json"(ECOS 원본 행)
    transform: "yoy"(전년동기대비 %), "pop"(직전 관측치 대비 %), "none". 미지정 시 지표 기본값 사용
    changes_only: True면 값이 바뀐 시점만 반환. 미지정 시 지표 기본값 사용

Returns:
    핵심 경제지표 시계열 데이터. 결과가 한 번에 다 담기지 않으면 최신 구간을 우선 반환합니다.

Inputs: indicator (required), end_date, transform, start_date, +3 more.

get_statistic_meta통계 메타데이터A

Read-onlyIdempotent

통계 데이터셋의 메타데이터(구조, 작성방법, 설명)를 조회합니다.

Args:
    data_name: 데이터셋 이름 (필수). 예: "경제심리지수", "소비자물가지수"
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 100)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    메타데이터

Inputs: data_name (required), language, end_count, start_count.

list_statistic_items통계표 세부항목A

Read-onlyIdempotent

특정 통계표의 세부 항목(항목코드, 지원 주기, 수록 기간, 단위)을 조회합니다.

Args:
    stat_code: 통계표코드 (필수). search_statistic_tables에서 찾은 코드 입력.
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 500)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    세부항목 목록 (has_more=true면 start_count를 늘려 다음 페이지 조회)

Inputs: stat_code (required), language, end_count, start_count.

search_statistics통계 시계열 조회A

Read-onlyIdempotent

통계 시계열 데이터를 조건별로 조회합니다.

★ 스마트 날짜: start_date, end_date를 생략하면 일간(D)은 최근 3개월, 그 외 주기는 최근 2년이 자동 설정됩니다.
★ 최신 우선: 결과가 end_count를 넘으면 가장 최근 구간을 반환하고 truncated=true와 안내를 붙입니다.
★ 증감률: transform="yoy"(전년동기대비 %) 또는 "pop"(직전 관측치 대비 %)를 지정하면 계산 열이 추가됩니다.
★ 포맷: "compact"(기본값, 계열별 [시점, 값] 배열), "csv", "json"(ECOS 원본 행)

★ 주기(cycle) 및 날짜 포맷 규칙:
- 연간(A): YYYY (예: "2024")
- 반기(S): YYYYS1, YYYYS2 (예: "2023S1")
- 분기(Q): YYYYQ1 ~ YYYYQ4 (예: "2024Q3")
- 월간(M): YYYYMM (예: "202401")
- 반월(SM): YYYYMMS1, YYYYMMS2 (예: "202401S1")
- 일간(D): YYYYMMDD (예: "20240315")

Args:
    stat_code: 통계표코드 (필수). 예: "722Y001"(기준금리), "901Y009"(소비자물가)
    cycle: 주기 (필수). A(연), S(반기), Q(분기), M(월), SM(반월), D(일)
    start_date: 검색 시작일 (선택)
    end_date: 검색 종료일 (선택)
    item_code1~4: 통계항목코드 (선택. 미지정 시 전체 세부항목 조회 — 결과가 매우 커질 수 있음)
    output_format: "compact"(기본값), "csv", "json"
    transform: "yoy", "pop", "none"(기본값)
    changes_only: True면 값이 바뀐 시점만 반환 (금리처럼 드물게 변하는 일별 지표에 유용)
    prefer_latest: 결과가 잘릴 때 최신 구간을 우선 반환 (기본값 True)
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 1000)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    시계열 데이터 (지정된 포맷)

Inputs: cycle (required), stat_code (required), end_date, language, +11 more.

search_statistic_tables통계표 검색·탐색A

Read-onlyIdempotent

통계표 이름으로 통계표코드(STAT_CODE)를 검색하거나, 통계표 분류 트리를 탐색합니다.

ECOS 통계표 전체의 로컬 인덱스를 사용하므로 API 호출 없이 즉시 응답합니다.
- keyword 지정: 이름 검색. 띄어쓰기로 나눈 단어가 모두 포함된 통계표를 관련도 순으로 반환
  ("소비자 물가" → "소비자물가지수"). parent_code를 함께 주면 그 분류 아래에서만 검색합니다.
- keyword 없이 parent_code 지정: 해당 분류의 직속 하위 항목 반환 (분류 노드 포함)
- 둘 다 없음: 최상위 분류 목록 반환

Args:
    keyword: 검색할 통계명 또는 키워드 (예: "물가", "금리", "환율", "경상수지")
    parent_code: 상위 분류 STAT_CODE (예: "0000000001")
    searchable_only: keyword 검색 시 실제 데이터 조회가 가능한 통계표(SRCH_YN='Y')만 반환 (기본값: True)
    limit: keyword 검색 시 최대 반환 개수 (기본값: 20)

Returns:
    통계표 목록 (STAT_CODE, STAT_NAME, CYCLE, SRCH_YN 등)

Inputs: limit, keyword, parent_code, searchable_only.

search_statistic_word통계 용어 사전A

Read-onlyIdempotent

경제/통계 용어의 정의를 검색합니다.

한국은행 통계용어사전에서 용어의 상세 설명을 조회합니다.
예: "기준금리", "GDP", "소비자물가지수", "통화승수" 등
(ECOS 방화벽 제약으로 '/'는 공백으로 바뀌어 검색됩니다.)

Args:
    word: 검색할 통계/경제 용어
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 10)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    용어 정의 목록

Inputs: word (required), language, end_count, start_count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-09-26 11:15 across 7 tools

Disambiguation3/5

get_popular_statistic, get_key_statistics, and search_statistics all return economic indicator data, so an agent must infer which mode fits the query. The descriptions clarify code-free keyword lookup versus generic code-based queries versus a fixed 100-indicator list, but 'popular' and 'key' remain semantically close.

Naming Consistency3/5

Names are grouped by action (get_, search_, list_) and remain readable, but the set mixes singular and plural forms ('statistic' vs 'statistics') and uses different object patterns like get_popular_statistic versus get_key_statistics. The naming is not chaotic, but it is not fully consistent.

Tool Count5/5

Seven tools is a well-scoped size for an economic-statistics server. Each tool serves a distinct stage of the workflow: quick lookup, generic retrieval, table discovery, item discovery, metadata, and dictionary lookup.

Completeness5/5

The tool surface covers the main ECOS workflows end to end: find a statistical table, inspect its items, retrieve time series, fetch metadata, look up terms, and access popular or major indicators. There are no obvious dead ends or missing core operations for the stated domain.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

ComePass — Korean Companies & Public ProcurementA
xyz.comepass.agents
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Finance Government Data
41
https://agents.comepass.xyz/mcp
Ecos KrA
io.github.pipeworx-io
ECOS — Bank of Korea Economic Statistics System.
Finance Government Data Open Data
482
https://gateway.pipeworx.io/ecos-kr/mcp
Kosis KrA
io.github.pipeworx-io
Korean national statistics (KOSIS) — browse, search and pull time series from Statistics Korea's…
Government Data Open Data
471
https://gateway.pipeworx.io/kosis-kr/mcp
kr-groundtruthA
io.github.ChloePark85
Korean fact-verification tools for AI agents: business registration, address, DART, apt prices, laws
Government Data Open Data Search
81
https://kr-groundtruth-mcp.vercel.app/api/mcp

Related MCP Servers

Korea Stats MCP
Search Government Data Open Data
Dayoooun
A
license
A
quality
B
maintenance
Enables natural language querying of Korean statistical data from KOSIS, including population, employment, GDP, housing prices, and more, with support for regional and trend analysis.
Updated 8 days ago (2026-11-05 06:34 UTC)
8
13 npm
17
MIT
kosis-mcp
updown256
A
license
Not graded
quality
D
maintenance
Enables querying Korean official statistics from KOSIS via natural language in MCP clients like Claude Desktop, wrapping the KOSIS OpenAPI for search, data retrieval, and metadata exploration.
Updated 4 months ago (2026-07-24 07:21 UTC)
MIT
ecos-mcp-server
Government Data Open Data Finance
josiah2050
F
license
Not graded
quality
C
maintenance
Enables querying Korean economic statistics via Bank of Korea's ECOS API, including time series data, statistical tables, items, key indicators, and terminology, with raw responses and error fidelity.
Updated 3 months ago (2026-08-09 03:08 UTC)
-
korea-bok-stats-mcp
Finance Government Data Open Data
hlucent
A
license
Not graded
quality
C
maintenance
Enables querying Bank of Korea ECOS economic statistics via Open API, including searching tables, retrieving time series data, and accessing key indicators.
Updated 3 months ago (2026-08-23 14:00 UTC)
MIT

🏦 ECOS MCP Server

✨ 핵심 기능

🛠️ MCP Tools (7개)

⚡ 토큰 최적화 포맷 (output_format)

📈 증감률·변경 시점 (transform, changes_only)

🗓️ 스마트 날짜 & 최신 구간 우선

📚 MCP Resources & Prompts

Resources

Prompts

📅 주기(Cycle)별 날짜 포맷 규칙

📌 주요 인기 통계표 프리셋

🚀 빠른 시작

1. 설치 (로컬 개발 시)

2. API 키 설정 (선택)

3. 자가 진단 헬스체크 실행

🔧 MCP 클라이언트 설정

Claude Desktop

방법 A: GitHub URL 직접 실행 (클론 불필요, 추천 ⭐)

방법 B: 로컬 클론 실행

Claude Code

Cursor

📖 사용 예시

1. 인기 지표 원스톱 조회 (get_popular_statistic)

2. 물가상승률 CSV 수신 후 차트 분석

3. 통계표 키워드 검색 및 계층 탐색 (search_statistic_tables)

4. 통계 용어 사전 검색 (search_statistic_word)

🧪 테스트 실행

📝 라이선스

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Korea Stats MCP

kosis-mcp

ecos-mcp-server

korea-bok-stats-mcp

⚡ 토큰 최적화 포맷 (`output_format`)

📈 증감률·변경 시점 (`transform`, `changes_only`)

1. 인기 지표 원스톱 조회 (`get_popular_statistic`)

3. 통계표 키워드 검색 및 계층 탐색 (`search_statistic_tables`)

4. 통계 용어 사전 검색 (`search_statistic_word`)