# 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
```