Cherry Studio 通过 MCP 对接思源笔记

作为思源笔记用户,我一直在思考怎样让思源笔记和大模型联动。

之前已经有人发过 Cursor 通过 MCP 对接思源笔记的教程:

AI 搜索你的所有笔记!思源笔记 +Cursor+MCP Server——打造你的个人专属 AI 资料库!(AI 大模型搜索笔记、内容总结、大纲凝练、RAG 搜索)

里面讲到了相关原理,感觉很有搞头。但我不太想把思源暴露给 Cursor,就一直在纠结。

但没有纠结太久,昨天 Cherry Studio 发布了 v1.1.1 版本,开始支持 MCP 服务。

这不开搞?

然后一通搞就搞通了。

Cursor 和 Cherry Studio 调用 MCP 的方法不太一样,折腾的时候踩了不少坑,因此我觉得还是得出个教程。

先看看效果:

image

image

以下是教程部分。

1. 安装 uv 和 node.js

首先这一步不太建议参考上面的教程,因为那个教程是 Linux 的安装方法。

我参考的是 Cherry Studio 官方推荐的:

如何在 Cherry Studio 中使用 MCP

里面有 Windows 的安装方法。

1.1 省流:

1.1.1 uv 安装

# 1. 打开 Powershell

# 2. 安装
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 3. 检查是否成功,报错就没成功
uv

1.1.2 nodejs 安装(二选一)

1.1.2.1 通过 bunk 安装
# 1. 打开 Powershell

# 2. 安装
powershell -c "irm bun.sh/install.ps1|iex"

# 3. 检查是否成功,报错就没成功
bun --version
1.1.2.2 官网下载安装

上面这些如果下载太慢了,甚至断联导致要重新下载,就开个代理。

2. 关于 MCP Server 的准备

Cursor 那个教程里是要自己下载 MCP Server 的,但是我发现 Cherry Studio 不能这么搞。

Cherry Studio 的 MCP Server 好像是在添加的时候直接从远程拉取的,不用自己先准备,自己准备的反而用不了。

3. 添加 MCP 服务器

这是官方文档给的命令结构:

### uv

‍```bash
# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "uv",
    "args": [
      "--directory",
      "parent_of_servers_repo/servers/src/sqlite",
      "run",
      "mcp-server-sqlite",
      "--db-path",
      "~/test.db"
    ]
  }
}
‍```

Cursor 的和官方的一致,但 Cherry Studio 和这个不一样,可能是考虑到上手难度问题(反而把我坑了)。

3.1 命令部分

首先,Cherry Studio 的命令不支持 uv,只支持 uvx,输入框里写了。

image

然后,你直接输入 uvx 可能是不行的,会出现这样的报错:

image

要换成绝对路径才能成功。

可以使用这个命令在 Poewshell 里查看 uv 的绝对路径:

Get-Command uv | Select-Object -ExpandProperty Source

返回的结果把 uv.exe 改成 uvx 填进去就行了。

image

image

斜线方向不用动,名字可以有中文。

3.2 参数部分

这部分就不用指定 MCP Server 的地址了,你只用指定具体哪个 Server,Cherry Studio 会帮你准备好。这里用的是 mcp-server-sqlite

如果你没有特意设置过,思源笔记的数据库路径就是 C:/Users/Windows用户名/SiYuan/temp/siyuan.db

正常情况下把下面的内容填到参数框里就行了。

mcp-server-sqlite
--db-path
C:/Users/Windows用户名/SiYuan/temp/siyuan.db

image

但考虑到网络环境问题,有可能拉取 Server 失败,Cherry Studio 贴心地为我们提供了换源功能,在前面加个 -i 替换的源 就行了。

这里用清华的源:

-i
https://pypi.tuna.tsinghua.edu.cn/simple
mcp-server-sqlite
--db-path
C:/Users/Windows用户名/SiYuan/temp/siyuan.db

填完界面应该是这样(这里是没换源的):

image

点确定,应该就成了。

4. 使用

首先确认你的模型是否支持 tool call 或者 function call。如果不支持,换模型。

为了配合 MCP,Cherry Studio 同时加入了函数调用支持。

不过要手动打开,在模型的设置界面:

image

这样勾上的模型就能使用 MCP 了。

然后回到聊天界面,在下面的工具栏里点开 MCP 服务器。

image

到此为止,Cherry Studio 就算是和思源笔记对接成功了。

但此时你的模型并不知道你的思源笔记数据库是什么结构。

为了让它不要懵逼,最好设置一个新的助手,加一个系统提示词。

此处可参考另一篇较早的 Cursor MCP 联动思源的文章:

https://ld246.com/forward?goto=https%3A%2F%2Fwww.zhihu.com%2Fquestion%2F5290049088%2Fanswer%2F109400122988

里面讲了思源数据库的结构。

我加的系统提示词是这样的:

image

然后就能畅游思源数据库啦!


2025.03.16 更新

收到评论区热心网友的提醒,又出了一个只读 SQLite 的 MCP 对接思源的教程:

Cherry Studio 通过只读 SQLite MCP 对接思源笔记

更推荐这个 MCP Server!

  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    24794 引用 • 101972 回帖 • 1 关注
  • MCP
    4 引用 • 47 回帖
2 操作
JeffreyChen 在 2025-03-16 01:04:09 更新了该帖
B3000Kcn 在 2025-03-16 00:07:15 更新了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • B3000Kcn 1 评论
    可以可以!
    TangQi 1 赞同
  • 其他回帖
  • B3000Kcn

    mac 安装 uv 和 nodejs 的方法不一样,确认一下有没有装上。mac 的路径格式好像和 Windows 也不一样

  • Mac 上添加 mcp 服务器不成功。

    image

    2 回复
  • xqh042 2 评论

    先填写 mcp-server-sqlite 拉取一遍服务器,再填写参数试试?或者更新最新版(貌似更新了一版修复了相关问题)

    我是先不填参数拉取,发现能拉取成功后再重新创建一个填写参数,就是 ds v3 这回答有点绷不住

    顺便建议如果内容太多,可以限制一下查询的时间

    PixPin20250314111623.png

    2 操作
    xqh042 在 2025-03-14 11:16:43 更新了该回帖
    xqh042 在 2025-03-14 11:09:05 更新了该回帖
    先填写 mcp-server-sqlite 拉取一遍服务器,也是一样报错。你是 Mac 系统吗?
    xnyshu
    @xnyshu windows,cherry studio github issue 里有一个 mcp 相关错误汇总贴可以看看。
    xqh042
  • 查看全部回帖