fiscal-api-mcp-

# fiscal-api-mcp National Finance API MCP Server - Provides budget, settlement, and fiscal project data to AI agents. ## Data Sources | Source | Content | Required Key | |------|------|---------| | openfiscaldata.go.kr | Fiscal projects, budget, settlement, and ministry status | OPENFISCAL_API_KEY (required) | | data.go.kr | Budget status by category and ministry | DATAGOKR_API_KEY (optional) | | nabostats.go.kr | Fiscal totals, tax burden rate, and national debt | NABOSTATS_API_KEY (optional) | ## API Key Issuance ### OPENFISCAL_API_KEY (required) 1. Visit [openfiscaldata.go.kr](https://openfiscaldata.go.kr) 2. Register/login 3. Go to My Page → OpenAPI application 4. Enter the issued key in `.env` ### DATAGOKR_API_KEY (optional) 1. Visit [data.go.kr](https://data.go.kr) 2. Register/login 3. Go to My Page → API application 4. Enter the issued key in `.env` ### NABOSTATS_API_KEY (optional) 1. Visit [nabo.go.kr](https://www.nabo.go.kr) 2. Register/login 3. Apply for OpenAPI 4. Enter the issued key in `.env` ## Quick Start ```bash git clone https://github.com/yangheeseok1/fiscal-api-mcp cd fiscal-api-mcp npm install cp .env.example .env # Open .env file and enter API keys npm run build ``` ## Claude Desktop Configuration Add the following to the Claude Desktop configuration file (`claude_desktop_config.json`). **Configuration file location:** - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "fiscal-api-mcp": { "command": "node", "args": ["C:/path/to/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" } } } } ``` > Change the `args` path to your actual project path. > Optional keys (`DATAGOKR_API_KEY`, `NABOSTATS_API_KEY`) can be removed if not present. Restart Claude Desktop after configuration to activate the tool. ## Tools (7) | Tool | Description | |------|------| | `fiscal_program` | Fiscal project search and execution status (core) | | `fiscal_budget` | Budget inquiry | | `fiscal_settlement` | Settlement inquiry | | `fiscal_ministry` | Ministry fiscal status | | `fiscal_stats` | Fiscal statistics (NABOSTATS) | | `discover_fiscal` | API catalog exploration | | `query_fiscal` | Direct API call | ## Example Usage Ask questions in natural language in Claude Desktop like this: ``` What is the 2024 education ministry budget? Show R&D fiscal project execution status Tell me the national debt trend from 2015 to 2024 List ministry fiscal projects under the Ministry of Finance Which ministry has the lowest execution rate in the 2023 expenditure settlement? ```