Obsidian Dictionary MCP Server
Obsidian vault 안에서 기술 용어 사전을 관리하기 위한 MCP 서버입니다.
설치 및 설정
1. 빌드
cd obsidian-dictionary-mcp
npm install
npm run build
2. Claude Desktop 설정
~/Library/Application Support/Claude/claude_desktop_config.json 파일을 열고 다음을 추가하세요:
{
"mcpServers": {
"dict": {
"command": "node",
"args": [
"/path/to/obsidian-dictionary-mcp/dist/index.js",
"--glossary-path",
"/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
]
}
}
}
3. Claude Code (CLI) 설정
Claude Code CLI에서 사용하려면 두 가지 방법 중 하나를 선택하세요:
방법 A: 프로젝트별 설정 (권장)
프로젝트 루트에 .mcp.json 파일을 생성:
{
"mcpServers": {
"dict": {
"command": "node",
"args": [
"/path/to/obsidian-dictionary-mcp/dist/index.js",
"--glossary-path",
"/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
]
}
}
}
방법 B: 전역 설정
~/.claude/settings.json 파일에 추가:
{
"mcpServers": {
"dict": {
"command": "node",
"args": [
"/path/to/obsidian-dictionary-mcp/dist/index.js",
"--glossary-path",
"/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
]
}
}
}
중요: 설정 파일을 생성하거나 수정한 후에는 Claude Code를 재시작해야 변경 사항이 적용됩니다. MCP 서버는 Claude Code가 시작될 때 설정을 읽어서 실행되기 때문입니다.
--glossary-path 옵션
--glossary-path 옵션으로 기본 용어집 경로를 설정하면:
- 도구 호출 시
file_path파라미터를 생략할 수 있습니다 - 설정하지 않으면 매번
file_path를 명시해야 합니다
사용 가능한 도구
append_entry
새 용어를 사전에 추가합니다.
파라미터:
file_path(선택): 사전 파일 경로 (기본 경로 설정 시 생략 가능)term: 추가할 용어dev_explanation: 개발자용 설명 (한국어, 1-2문장)simple_explanation: 비개발자용 설명 (한국어, 1문장)example: 예시 (한국어, 1줄)
search_entry
용어가 이미 존재하는지 확인합니다.
파라미터:
file_path(선택): 사전 파일 경로 (기본 경로 설정 시 생략 가능)term: 검색할 용어
get_entry
특정 용어의 내용만 가져옵니다 (전체 파일 X).
파라미터:
file_path(선택): 사전 파일 경로 (기본 경로 설정 시 생략 가능)term: 가져올 용어
list_terms
사전에 있는 모든 용어 목록을 반환합니다 (용어명만, 내용 X).
파라미터:
file_path(선택): 사전 파일 경로 (기본 경로 설정 시 생략 가능)
사전 엔트리 형식
### {term}
- 개발자용 설명: {개발자 관점의 설명}
- 비개발자용 설명: {쉬운 설명}
- 예시: {짧은 예시}
Obsidian Vault 경로
사전 파일 경로 예시:
/path/to/your/ObsidianVault/Glossary/개발용어사전.md