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

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

---

설치 (한 줄)

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

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

---

수동 설치 (개발자)

uvx로 실행

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

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

업데이트

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
• macOS 또는 Linux
• Python 3.10 이상 (uv가 자동 설치·관리)

---

라이선스

MIT