使用说明
黑曜岩出露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文件，以便更好地利用这些工具。