fiscal-api-mcp

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.

Category
Visit Server

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

  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년 세출결산에서 집행률이 가장 낮은 부처는?

Recommended Servers

playwright-mcp

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

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.

Official
Featured
TypeScript
Kagi MCP Server

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.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured