Skip to main content
Glama
db_mcp

db_mcp

by namjiman

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

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


설치 (한 줄)

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

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


Related MCP server: Academic MCP

수동 설치 (개발자)

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

Available Tools

6 tools
get_fulltextC

글 한 편의 원문 전문 + 각주 + 원주를 반환한다(캐시 우선).

Inputs: data_id (required).

get_translationC

글의 국역(번역) 본문을 반환한다. 번역이 없으면 has_translation=false.

Inputs: data_id (required).

list_collectionsA

지원하는 ITKC 컬렉션 목록을 반환한다.

각 항목: id(컬렉션코드), name(한글명), fields(지원 검색필드 코드 목록). search_db의 collection 파라미터에 id를 그대로 쓸 수 있다.

Inputs: no named parameters. Returns: result

search_all_collectionsA

모든 컬렉션을 동시에 검색해 컬렉션별 결과를 반환한다.

field: 한글('본문'/'전체' 등) 또는 코드(BD/AA 등). limit: 컬렉션당 최대 결과 수. 반환: {컬렉션ID: {collection_name, totalCount, docs[]}, ...}

Inputs: query (required), field, limit.

search_dbA

특정 컬렉션에서 검색한다.

collection: 컬렉션 코드(MO/BT/GO/KP/KH/JT/JR/ST/IT). list_collections로 확인. field: 한글('본문'/'서지'/'저자'/'권차문체'/'기사명'/'전체') 또는 코드(BD/SJ/AU/KW/GS/AA). 결과의 data_id로 get_fulltext 또는 get_translation을 호출해 전문을 받는다.

Inputs: query (required), collection (required), field, limit, +1 more.

search_in_dirB

특정 자료/서지 디렉터리(dir_id) 안에서만 본문 검색한다.

Inputs: query (required), dir_id (required), collection, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct operation: retrieving full text, translation, listing collections, and three different search modes (all, specific collection, directory). No significant overlap, and descriptions clarify the differences.

    Naming Consistency4/5

    Tool names follow a verb_noun pattern with snake_case (e.g., get_fulltext, list_collections). However, 'search_db' is slightly less descriptive than 'search_collection' and breaks the pattern of including the object in the name.

    Tool Count5/5

    With 6 tools, the server covers core functionalities (listing, searching, retrieving content) without being excessive or minimal. The scope is well-suited for a database query server.

    Completeness4/5

    The set covers essential read operations: collection metadata, multi-modal search, and content retrieval. Missing is a dedicated tool to fetch document metadata without full text, but search results likely include enough info.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables access to Korean Bible translations from bskorea.or.kr, allowing users to retrieve chapters, verses, search for keywords, and compare translations across different Korean Bible versions.
      6
      59 npm
      3
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables AI tools to search and retrieve data from various South Korean and Japanese academic databases, including research journals, historical records, and legislative information.
      3
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and viewing 1.89 million entries of the Seungjeongwon Ilgi and 380,000 articles of the Annals of the Joseon Dynasty from a local PostgreSQL database via Claude Desktop.
      -