使用说明
抄写员mcp
MCP服务器,允许AI代理进行CRUD访问 黑曜石 笔记通过 实时同步的CouchDB后端。
内置于 迪诺 和官方 livesync通用库 图书馆。透明地处理加密、压缩和路径混淆。
工具
| 工具 | 说明 |
|---|---|
vault_status |
Vault概述--文档计数、文件夹、加密/压缩状态 |
vault_list |
列出注释,可选择按文件夹或glob模式过滤 |
vault_read |
读取笔记的内容和元数据 |
vault_search |
在所有笔记中进行全文搜索(不区分大小写) |
vault_write |
创建或更新笔记 |
vault_delete |
删除注释 |
先决条件
- 迪诺 v2+
- 一个CouchDB实例 黑曜石LiveSync 数据库
设置
-
克隆子模块:
git clone --recurse-submodules https://github.com/edimuj/scribe-mcp.git cd scribe-mcp -
复制和编辑环境文件:
cp .env.example .env变量 必填 描述 SCRIBE_COUCHDB_URL是 沙发数据库URL(例如。 http://localhost:5984)SCRIBE_COUCHDB_USER是 CouchDB用户名 SCRIBE_COUCHDB_PASS是 CouchDB密码 SCRIBE_COUCHDB_DB是 数据库名称(例如。 obsidian-livesync)SCRIBE_PASSPHRASE如果E2EE Vault密码(仅在Vault使用端到端加密时需要) -
运行:
deno task start
克劳德代码/MCP客户端配置
添加到MCP客户端配置中(例如。 .claude.json):
{
"mcpServers": {
"scribe": {
"command": "deno",
"args": ["run", "-A", "--no-check", "/path/to/scribe-mcp/src/main.ts"],
"env": {
"SCRIBE_COUCHDB_URL": "http://localhost:5984",
"SCRIBE_COUCHDB_USER": "admin",
"SCRIBE_COUCHDB_PASS": "changeme",
"SCRIBE_COUCHDB_DB": "obsidian-livesync",
"SCRIBE_PASSPHRASE": "your-passphrase"
}
}
}
}
许可证
麻省理工学院