fiscal-api-mcp

국가재정 API MCP 서버 — 예산·결산·재정사업 데이터를 AI 에이전트에게 제공합니다.

데이터 소스

소스	내용	필요 키
openfiscaldata.go.kr	재정사업·예산·결산·부처현황	OPENFISCAL_API_KEY (필수)
data.go.kr	분야별·부처별 예산현황	DATAGOKR_API_KEY (선택)
nabostats.go.kr	재정총량·조세부담률·국가채무	NABOSTATS_API_KEY (선택)

API 키 발급

OPENFISCAL_API_KEY (필수)

openfiscaldata.go.kr 접속
회원가입 / 로그인
마이페이지 → OpenAPI 신청
발급된 키를 .env에 입력

DATAGOKR_API_KEY (선택)

data.go.kr 접속
회원가입 / 로그인
마이페이지 → API 활용신청
발급된 키를 .env에 입력

NABOSTATS_API_KEY (선택)

nabo.go.kr 접속
회원가입 / 로그인
OpenAPI 신청
발급된 키를 .env에 입력

빠른 시작

git clone https://github.com/yangheeseok1/fiscal-api-mcp
cd fiscal-api-mcp
npm install
cp .env.example .env
# .env 파일을 열어 API 키 입력
npm run build

Claude Desktop 설정

Claude Desktop 설정 파일(claude_desktop_config.json)에 아래를 추가합니다.

설정 파일 위치:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fiscal-api-mcp": {
      "command": "node",
      "args": ["C:/경로/fiscal-api-mcp/dist/index.js"],
      "env": {
        "OPENFISCAL_API_KEY": "your_key_here",
        "DATAGOKR_API_KEY": "your_key_here",
        "NABOSTATS_API_KEY": "your_key_here"
      }
    }
  }
}

args 경로는 본인의 실제 프로젝트 경로로 변경하세요.
선택 키(DATAGOKR_API_KEY, NABOSTATS_API_KEY)는 없으면 해당 줄을 삭제해도 됩니다.

설정 후 Claude Desktop을 재시작하면 도구가 활성화됩니다.

도구 (7개)

도구	설명
`fiscal_program`	재정사업 검색·집행현황 (핵심)
`fiscal_budget`	예산안 조회
`fiscal_settlement`	결산 조회
`fiscal_ministry`	부처 재정현황
`fiscal_stats`	재정통계 (NABOSTATS)
`discover_fiscal`	API 카탈로그 탐색
`query_fiscal`	직접 API 호출

사용 예시

Claude Desktop에서 아래처럼 자연어로 질문하면 됩니다.

2024년 교육부 예산이 얼마야?
R&D 재정사업 집행현황 보여줘
2015년부터 2024년까지 국가채무 추이 알려줘
기재부 소관 재정사업 목록 뽑아줘
2023년 세출결산에서 집행률이 가장 낮은 부처는?

fiscal-api-mcp

fiscal-api-mcp

데이터 소스

API 키 발급

OPENFISCAL_API_KEY (필수)

DATAGOKR_API_KEY (선택)

NABOSTATS_API_KEY (선택)

빠른 시작

Claude Desktop 설정

도구 (7개)

사용 예시

Reviews