# db_mcp — 한국고전종합DB MCP 서버

Claude Desktop에서 [한국고전종합DB(ITKC)](https://db.itkc.or.kr)를 직접 검색합니다.  
승정원일기, 일성록, 조선왕조실록, 한국문집총간 등 **9개 컬렉션**을 지원합니다.

---

## 설치 (한 줄)

```bash
curl -fsSL https://raw.githubusercontent.com/namjiman/db_mcp/main/install.sh | bash
```

Claude Desktop을 재시작하면 바로 사용할 수 있습니다.

---

## 수동 설치 (개발자)

### uvx로 실행

```bash
uvx --from git+https://github.com/namjiman/db_mcp db-mcp
```

### claude_desktop_config.json 직접 수정

파일 위치:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "db_mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/namjiman/db_mcp", "db-mcp"]
    }
  }
}
```

### 업데이트

```bash
uvx upgrade db-mcp
```

---

## 제공 도구

| 도구 | 설명 |
|------|------|
| `list_collections` | 지원 컬렉션 목록 (코드·한글명·필드) |
| `search_db` | 컬렉션 지정 검색 |
| `search_all_collections` | 전체 컬렉션 동시 검색 |
| `search_in_dir` | 특정 자료 디렉터리 내 검색 |
| `get_fulltext` | 원문 전문 + 각주 + 원주 (캐시) |
| `get_translation` | 국역 본문 |

---

## 지원 컬렉션

| 코드 | 한글명 | 지원 검색필드 |
|------|-------|-------------|
| MO | 한국문집총간 | 본문·저자·권차문체·기사명·전체 |
| BT | 고전번역서 | 본문·저자·권차문체·기사명·전체 |
| GO | 고전원문 | 본문·저자·권차문체·기사명·전체 |
| KP | 한국고전총간 | 본문·저자·권차문체·기사명·전체 |
| KH | 한국경학자료집성 | 본문·저자·전체 |
| JT | 조선왕조실록(국역) | 본문·서지·기사명·전체 |
| JR | 조선왕조실록(신역) | 본문·서지·기사명·전체 |
| ST | 승정원일기 | 본문·기사명·전체 |
| IT | 일성록 | 본문·기사명·전체 |

---

## 요구사항

- [Claude Desktop](https://claude.ai/download)
- macOS 또는 Linux
- Python 3.10 이상 (uv가 자동 설치·관리)

---

## 라이선스

MIT