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 (필수)

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

DATAGOKR_API_KEY (선택)

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

NABOSTATS_API_KEY (선택)

1. nabo.go.kr 접속
2. 회원가입 / 로그인
3. OpenAPI 신청
4. 발급된 키를 .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년 세출결산에서 집행률이 가장 낮은 부처는?