Obsidian Dictionary MCP Server

黑曜石词典MCP服务器

在Obsidian vault中管理技术术语词典的MCP服务器。

安装和设置

1.构建

cd obsidian-dictionary-mcp
npm install
npm run build

2.Claude桌面设置

~/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