# 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](https://openfiscaldata.go.kr) 접속
2. 회원가입 / 로그인
3. 마이페이지 → OpenAPI 신청
4. 발급된 키를 `.env`에 입력

### DATAGOKR_API_KEY (선택)
1. [data.go.kr](https://data.go.kr) 접속
2. 회원가입 / 로그인
3. 마이페이지 → API 활용신청
4. 발급된 키를 `.env`에 입력

### NABOSTATS_API_KEY (선택)
1. [nabo.go.kr](https://www.nabo.go.kr) 접속
2. 회원가입 / 로그인
3. OpenAPI 신청
4. 발급된 키를 `.env`에 입력

## 빠른 시작

```bash
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`

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