黑曜岩出露mcp
我见过的大多数黑曜石MCP只是重新实现了“读笔记、写笔记、按标签/关键字搜索笔记”的基本功能,更好,但基本上与标准的claude代码工具相同。
一个MCP服务器,允许Claude Code深度访问您的黑曜石保险库。28个用于搜索、导航和分析知识图的工具——结构分析、语义检索、时间序列跟踪等。
你的保险库成为克劳德可以阅读、搜索和推理的实时知识库。
安装
从你的黑曜石金库里,跑:
curl -fsSL https://raw.githubusercontent.com/Gassandrid/obsidian-emergent-mcp/main/install.sh | bash这会将两个Python文件安装到您的vault中 .claude/ 目录,设置 .mcp.json,并安装依赖关系。当您在Claude Code中打开保管库时,MCP服务器会自动启动。
需求
- Python 3.10+
- 黑曜石拱顶(必须有
.obsidian/目录) - 克劳德代码CLI
此工具只有在您正在对vault进行Git版本控制时才真正有用,否则请不要使用此工具。
智能连接还将增加一些行为。我们不将其用于RAG,而只是将余弦sim用于相关音符。
工具
搜索和阅读
| 工具 | 它做什么 |
|---|---|
vault_rag | 主要检索。 自由文本查询→ TF-IDF+嵌入再银行→ 带摘录的排名结果 |
vault_search | 在标题、内容、标签之间进行子字符串搜索——以进行精确查找 |
vault_read | 阅读笔记的内容、标签和链接数 |
图形导航
| 工具 | 它做什么 |
|---|---|
vault_backlinks | 什么链接到此注释 |
vault_forward_links | 此注释链接到什么 |
vault_context | 语义相关注释(嵌入+链接接近) |
vault_related | 结构相关注释(共享邻居) |
vault_hubs | 金库中连接最多的钞票 |
vault_orphans | 没有输入或输出链接的笔记 |
时间序列(git支持)
| 工具 | 它做什么 |
|---|---|
vault_attention_flow | 您关注的主题是什么?按标签/文件夹分组的编辑,带有趋势检测功能 |
vault_topic_timeline | 知识领域如何随时间增长——按周/月/日排列的编辑 |
vault_note_history | 特定笔记的完整编辑历史记录——每个快照的提交、字数、链接数 |
vault_diff | 结构差异:新增/删除笔记,N天内链接更改 |
vault_recent | 最近修改的笔记 |
vault_knowledge_velocity | 哪些笔记被编辑得最多 |
vault_link_weights | 通过共同编辑频率增强链接强度 |
结构分析
| 工具 | 它做什么 |
|---|---|
vault_clusters | 通过标签传播进行社区检测 |
vault_concept_gaps | 结构孔:缺钞、短轮毂、桥缝 |
vault_broken_links | 带有推断主题标签的损坏维基链接,可过滤 |
vault_maturity | 按开发成熟度(字数、链接、新旧程度)对笔记进行评分 |
vault_prereq_tree | 从根注释学习依赖树 |
vault_stats | 全局指标:注释/链接计数、标签分布 |
vault_tags | 使用示例注释标记频率 |
vault_suggest_links | 查找语义相似但未链接的注释对 |
vault_batch_tag | 预览批量标签操作(仅限模拟运行) |
vault_open_questions | 提取未解决的问题、待办事项、未选中的复选框 |
代理内存
| 工具 | 它做什么 |
|---|---|
vault_journal_write | 为今后的会议记录观察结果 |
vault_journal_read | 回忆过去的观察结果,可按标签和时间过滤 |
______________________________________________________________________
建议提示Claude更新vault Claude.md文件,以便更好地利用这些工具。
