插件管理MCP服务器
项目介绍
一款适用于siyuan-note的MCP服务器插件
这是一个为Siyuan Note提供MCP服务的插件。
⚠️ 重大变更：从v0.1.x升级到v0.2.x引入了重大变更。CHANGELOG_zh-CN
✨ 快速开始
- 从市场下载或 1. 解压Release中的
package.zip，2. 将文件夹移动到workspace/data/plugins/，3. 并将文件夹重命名为syplugin-anMCPServer； - 启用插件；
- 插件默认监听端口
16806（主机：127.0.0.1），请使用http://127.0.0.1:16806/sse作为服务器访问地址；
⭐ 如果这对你有帮助，请考虑给它一个星！
🔧 支持的工具
-
[搜索]
关键词搜索；暂时移除，如需请反馈- SQL搜索；
- 笔记索引问答（使用RAG后端服务，测试功能）；
-
[检索]
- 根据ID获取文档kramdown；
- 列出笔记本；
- 根据ID获取反向链接；
- 获取子文档ID；
- 读取属性；
根据日期读取日记条目；暂时移除，如需请反馈
-
[写入]
-
文档类型
- 在日记中追加内容；
- 根据ID在文档中追加内容；
- 在指定位置创建新文档；
-
闪卡类型
- 从Markdown内容创建闪卡；
- 根据块ID创建闪卡；
- 根据块ID删除闪卡；
-
属性
- 修改属性；
-
❓ 常见问题
-
Q: 如何在MCP客户端中使用它？ 请参阅后面的章节；
-
Q: 有哪些常见的MCP客户端？
-
Q: 插件支持身份验证吗？
- 版本v0.2.0现在支持身份验证。在插件设置中设置身份验证令牌后，MCP客户端需要配置
authorization请求头，值为Bearer YourToken；
- 版本v0.2.0现在支持身份验证。在插件设置中设置身份验证令牌后，MCP客户端需要配置
-
Q: 它可以在Docker中使用吗？
-
不可以，该插件依赖于Node.js环境，不支持在移动设备或Docker上运行。
要支持部署在Docker中的SiYuan，建议切换到其他MCP项目。一些相关项目可能在此列出这里。
或者，将此插件与SiYuan前端解耦。
-
如何在MCP客户端中配置？
不同的MCP客户端需要不同的配置方法。请参考MCP客户端文档。
MCP客户端不断更新，因此这里的配置或使用说明可能不直接适用，仅供参考。
这里假设：插件端口是
16806，授权令牌是abcdefg。
修改MCP应用程序的配置，选择Streamable HTTP类型，并配置端点。
支持Streamable HTTP的客户端
以下配置以Cherry Studio为例。不同的MCP客户端可能需要不同的配置格式—请参考MCP客户端文档。
无授权令牌的插件
- 类型：选择Streamable HTTP (
streamablehttp)； - URL：
http://127.0.0.1:16806/mcp； - Headers：留空；
有授权令牌的插件
- 类型：选择Streamable HTTP (
streamablehttp)； - URL：
http://127.0.0.1:16806/mcp； - Headers：
Authorization=Bearer abcedfg；
仅支持Stdio的客户端
如果MCP客户端不支持基于HTTP的通信，而只支持stdio，则需要一种转换方法。
这里我们使用node.js + mcp-remote@next。
-
下载Node.js：https://nodejs.org/en/download
-
安装
mcp-remote@next：npm install -g mcp-remote@next
以下配置以5ire为例。不同的MCP客户端可能需要不同的配置格式—请参考MCP客户端文档。
无授权令牌的插件
命令：
npx mcp-remote@next http://127.0.0.1:16806/mcp
有授权令牌的插件
命令：
npx m
cp-remote@next http://127.0.0.1:16806/mcp --header Authorization:${AUTH_HEADER}
环境变量：
名称：AUTH_HEADER
值：Bearer abcdefg
🙏 参考资料及致谢
部分依赖项列在
package.json中。
| 开发者/项目 | 项目描述 | 引用 |
|---|---|---|
| thuanpham582002/tabby-mcp-server | 提供终端软件Tabby内的MCP服务；MIT License | MCP服务实现方法 |
| wilsons / Frostime | 系统提示CC BY-SA 4.0 | 位于static/的系统提示等 |