eviebot mcp黑曜石
一个MCP服务器,允许克劳德直接访问黑曜石保险库。通过自然对话阅读、编写、搜索和管理笔记,包括日常笔记、模板、维基链接、标签和frontmatter。
在后面的无头Mac Mini上运行 Eviebot MCP网关不需要黑曜石应用程序或插件;直接对vault的markdown文件进行操作。
工具
备注 — read_note, write_note, edit_note, append_to_note, delete_note, move_note
搜索 — search_notes (全文), search_by_tag, get_backlinks, get_outgoing_links
每日笔记 — get_daily_note, append_to_daily_note
前言 — get_frontmatter, set_frontmatter
模板 — list_templates, create_from_template
金库 — vault_info, list_notes
设置
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
OBSIDIAN_VAULT_PATH=~/Documents/Obsidian python server.py服务器启动于 127.0.0.1:3001网关将其代理到 obsidian 命名空间,因此工具显示为 obsidian_read_note, obsidian_search_notes等等。
配置
唯一需要的配置是 OBSIDIAN_VAULT_PATH 环境变量。其他所有内容都是从Obsidian自己的配置文件中读取的(.obsidian/daily-notes.json, .obsidian/templates.json),当这些文件不存在时,使用合理的默认值。
测试
pytest涵盖所有模块的78个测试。测试使用临时保险库夹具——不需要真正的保险库访问权限。
设计细节
看 规格.md 完整规范:工具签名、路径解析行为、wikilink解析、Moment.js日期格式映射和安全边界。
