使用说明
黑曜石词典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
