思源接入AI(cursor+mcp)

前言

之前一直在用思源笔记做知识管理，但随着笔记越来越多，手动检索和整理变得低效。最近发现可以通过 Cursor IDE + MCP 直接接入思源笔记的 API，让AI帮我查找修改笔记，还能借助大模型的能力对笔记的优缺点进行评价，感觉挺实用，记录一下配置过程。

原理

思源笔记在本地运行时会暴露 HTTP API（默认 127.0.0.1:6806）
SiYuan MCP Server - @porkll/siyuan-mcp 提供了相关mcp工具以及配置文件：

{
  "mcpServers": {
    "siyuan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@porkll/siyuan-mcp",
        "stdio",
        "--token",
        "你的API_TOKEN",
        "--baseUrl",
        "http://127.0.0.1:6806"
      ]
    }
  }
}

这里的API Token用于鉴权

配置过程

先去思源笔记 设置 → 关于 中复制 API Token，填入配置文件的 --token 字段。然后把配置粘贴到 Cursor 的 MCP 配置文件中，两种方式：

全局生效：~/.cursor/mcp.json
仅当前项目：项目根目录下 .cursor/mcp.json

配置保存后，重新打开 Cursor。MCP 服务会在 Cursor 启动时自动加载。

可用功能

配置成功后，可以通过自然语言使用以下工具：

类别	工具	功能
搜索	`unified_search`	按内容/文件名/标签组合搜索
查询	`get_document_content`	获取文档 Markdown 内容
查询	`get_document_tree`	获取文档树结构
查询	`get_recently_updated_documents`	获取最近更新文档
查询	`list_notebooks`	列出所有笔记本
写入	`create_document`	创建新文档
写入	`update_document`	覆盖更新文档
写入	`append_to_document`	追加内容到文档
写入	`append_to_daily_note`	追加到每日笔记
管理	`move_documents`	移动文档
标签	`list_all_tags` / `batch_replace_tag`	标签查询与批量替换
备份	`create_snapshot` / `rollback_to_snapshot`	快照与回滚