db_mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@db_mcp search for '임진왜란' in the Annals of the Joseon Dynasty"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
db_mcp — 한국고전종합DB MCP 서버
Claude Desktop에서 한국고전종합DB(ITKC)를 직접 검색합니다.
승정원일기, 일성록, 조선왕조실록, 한국문집총간 등 9개 컬렉션을 지원합니다.
설치 (한 줄)
curl -fsSL https://raw.githubusercontent.com/namjiman/db_mcp/main/install.sh | bashClaude Desktop을 재시작하면 바로 사용할 수 있습니다.
Related MCP server: Academic MCP
수동 설치 (개발자)
uvx로 실행
uvx --from git+https://github.com/namjiman/db_mcp db-mcpclaude_desktop_config.json 직접 수정
파일 위치:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.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제공 도구
도구 | 설명 |
| 지원 컬렉션 목록 (코드·한글명·필드) |
| 컬렉션 지정 검색 |
| 전체 컬렉션 동시 검색 |
| 특정 자료 디렉터리 내 검색 |
| 원문 전문 + 각주 + 원주 (캐시) |
| 국역 본문 |
지원 컬렉션
코드 | 한글명 | 지원 검색필드 |
MO | 한국문집총간 | 본문·저자·권차문체·기사명·전체 |
BT | 고전번역서 | 본문·저자·권차문체·기사명·전체 |
GO | 고전원문 | 본문·저자·권차문체·기사명·전체 |
KP | 한국고전총간 | 본문·저자·권차문체·기사명·전체 |
KH | 한국경학자료집성 | 본문·저자·전체 |
JT | 조선왕조실록(국역) | 본문·서지·기사명·전체 |
JR | 조선왕조실록(신역) | 본문·서지·기사명·전체 |
ST | 승정원일기 | 본문·기사명·전체 |
IT | 일성록 | 본문·기사명·전체 |
요구사항
macOS 또는 Linux
Python 3.10 이상 (uv가 자동 설치·관리)
라이선스
MIT
Available Tools
6 toolsget_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
Scored across 6 tools
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.
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.
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.
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
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Korean accounting standards, audit, tax and legal sources and rulings, with citation checks
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
Search and read ~250k pages of Chinese Buddhist texts from Xianmi Library (xianmi.co).
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.659 npm3MIT
- FlicenseBqualityDmaintenanceEnables AI tools to search and retrieve data from various South Korean and Japanese academic databases, including research journals, historical records, and legislative information.3-
- FlicenseNot gradedqualityCmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceEnables searching and retrieving Korean Constitutional Court decisions using the official Open API, with search filters and full-text retrieval.-