Obsidian笔记CRUD服务

一个为AI代理提供对Obsidian笔记进行CRUD操作的服务器,通过LiveSync的CouchDB后端实现透明加密、压缩和路径混淆。

  • by edimuj
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 edimuj/scribe-mcp

使用说明

抄写员mcp

MCP服务器,允许AI代理进行CRUD访问 黑曜石 笔记通过 实时同步的CouchDB后端。

内置于 迪诺 和官方 livesync通用库 图书馆。透明地处理加密、压缩和路径混淆。

工具

工具 说明
vault_status Vault概述--文档计数、文件夹、加密/压缩状态
vault_list 列出注释,可选择按文件夹或glob模式过滤
vault_read 读取笔记的内容和元数据
vault_search 在所有笔记中进行全文搜索(不区分大小写)
vault_write 创建或更新笔记
vault_delete 删除注释

先决条件

设置

  1. 克隆子模块:

    git clone --recurse-submodules https://github.com/edimuj/scribe-mcp.git
    cd scribe-mcp
    
  2. 复制和编辑环境文件:

    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使用端到端加密时需要)
  3. 运行:

    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"
      }
    }
  }
}

许可证

麻省理工学院