About fiscal-api-mcp
fiscal-api-mcp is an MCP server in the Finance category: provides AI agents with Korean national fiscal data (budgets, settlements, and fiscal programs) from multiple government APIs through 7 tools, enabling natural language queries. It has been installed 0 times through Conduid.
Install
git clone https://github.com/yangheeseok1/fiscal-api-mcp-This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about fiscal-api-mcp
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
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년 세출결산에서 집행률이 가장 낮은 부처는?
README mirrored from the source repository yesterday. The original is authoritative.