# Obsidian Dictionary MCP Server
Obsidian vault 안에서 기술 용어 사전을 관리하기 위한 MCP 서버입니다.
## 설치 및 설정
### 1. 빌드
```bash
cd obsidian-dictionary-mcp
npm install
npm run build
```
### 2. Claude Desktop 설정
`~/Library/Application Support/Claude/claude_desktop_config.json` 파일을 열고 다음을 추가하세요:
```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` 파일을 생성:
```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` 파일에 추가:
```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` *(선택)*: 사전 파일 경로 (기본 경로 설정 시 생략 가능)
## 사전 엔트리 형식
```markdown
### {term}
- 개발자용 설명: {개발자 관점의 설명}
- 비개발자용 설명: {쉬운 설명}
- 예시: {짧은 예시}
```
## Obsidian Vault 경로
사전 파일 경로 예시:
```
/path/to/your/ObsidianVault/Glossary/개발용어사전.md
```
