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