知识助理MCP服务器
MCP（模型上下文协议）服务器，用于从Claude Code查询黑曜石库。
功能
| 输出 | 描述 |
|---|---|
knowledge_search | 具有逻辑和的多术语搜索 |
knowledge_read | 阅读注释的完整内容 |
knowledge_related | 查找与概念相关的注释 |
knowledge_stats | Vault统计信息（注释、标记、类型） |
knowledge_explore_tag | 按标签列出注释 |
knowledge_backlinks | 查找注释的反向链接 |
knowledge_recent | 最近修改的注释 |
安装
先决条件
- Python 3.10+
- UV（包管理器）
配置克劳德代码
Linux/macOS
添加到 ~/.claude/settings.json :
{
"mcpServers": {
"knowledge-assistant": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/knowledge-assistant-mcp",
"python",
"-m",
"src.server"
],
"env": {
"KNOWLEDGE_VAULT_PATH": "/home/username/Documents/Knowledge",
"KNOWLEDGE_INDEX_PATH": "/home/username/.knowledge/notes-index.json"
}
}
}
}视窗
{
"mcpServers": {
"knowledge-assistant": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\knowledge-assistant-mcp",
"python",
"-m",
"src.server"
],
"env": {
"KNOWLEDGE_VAULT_PATH": "C:\\Users\\username\\Documents\\Knowledge",
"KNOWLEDGE_INDEX_PATH": "C:\\Users\\username\\.knowledge\\notes-index.json"
}
}
}
}使用
多术语研究
knowledge_search("PowerShell UTF-8")→查找包含的注释 所有 租赁条款（AND）
读一张便条
knowledge_read("Concepts/C_Zettelkasten.md")相关注释
knowledge_related("PowerShell")资源管理器取消标记
knowledge_explore_tag("dev/powershell")配置
路径可以通过环境变量进行配置：
| 变量 | 描述 | 默认Linux/macOS | 默认Windows |
|---|---|---|---|
KNOWLEDGE_VAULT_PATH | 黑曜石 | ~/Documents/Knowledge | %USERPROFILE%\Documents\Knowledge |
KNOWLEDGE_INDEX_PATH | 索引文件路径 | ~/.knowledge/notes-index.json | %USERPROFILE%\.knowledge\notes-index.json |
KNOWLEDGE_CACHE_TTL | 缓存持续时间（秒） | 60 | 60 |
保险库结构
Knowledge/
├── _Inbox/ # Nouvelles captures
├── Concepts/ # Notes atomiques (C_*)
├── Conversations/ # Sessions Claude
├── Projets/ # Notes projet
├── Références/ # Documentation
└── ...许可证
麻省理工学院