fiscal-api-mcp
Provides AI agents with Korean national fiscal data (budgets, settlements, and fiscal programs) from multiple government APIs through 7 tools, enabling natural language queries.
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년 세출결산에서 집행률이 가장 낮은 부처는?
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.