GALIAIS/siyuan-mcp-server
3.1
If you are the rightful owner of siyuan-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Model Context Protocol (MCP) server for SiYuan Note provides seamless integration with SiYuan Note through its API.
SiYuan MCP Server
一个为思源笔记(SiYuan)设计的 Model Context Protocol (MCP) 服务器,提供 AI 集成和智能知识管理功能。
🌟 核心特性
📝 笔记管理
- 全文搜索: 支持关键词搜索和高级查询语法
- 块操作: 创建、读取、更新和删除笔记块
- 文档管理: 完整的文档生命周期管理
- 笔记本操作: 笔记本的创建、列表和管理
🏷️ 标签系统
- 智能标签: 自动标签提取和管理
- 标签搜索: 基于标签的内容发现
- 标签统计: 使用频率和趋势分析
🔍 高级搜索
- 递归搜索: 深度内容挖掘
- 批量操作: 高效的批量数据处理
- 引用分析: 内容关联和引用追踪
- 资源发现: 自动发现相关资源和内容
🚀 性能优化
- Token 优化: 智能内容压缩和优化
- 缓存机制: 多层缓存提升响应速度
- 批量处理: 高效的批量数据操作
- 性能监控: 实时性能指标和优化建议
🤖 AI 集成
- 智能助手: AI 驱动的内容分析和建议
- 上下文管理: 智能上下文存储和检索
- 提示模板: 预定义的 AI 交互模板
🚀 快速开始
1. 安装思源笔记
- 下载安装包:https://github.com/siyuan-note/siyuan/releases
- 启动思源笔记
2. 配置思源笔记
- 启动思源笔记
- 设置 → 关于 → API token
- 复制API Token至SIYUAN_API_TOKEN
MCP配置
{
"mcpServers": {
"siyuan": {
"command": "npx",
"args": ["siyuan-mcp-server"],
"env": {
"SIYUAN_API_TOKEN": "your-api-token"
}
}
}
}
🛠️ 技术栈
- 运行时: Node.js 18+
- 语言: TypeScript
- 协议: Model Context Protocol (MCP)
- HTTP客户端: Axios
- 构建工具: TypeScript Compiler
📡 MCP 工具
系统工具
system.health
- 系统健康检查system.discover-ports
- 端口自动发现
笔记操作
notes.search
- 笔记搜索blocks.get
- 获取块内容blocks.create
- 创建新块blocks.update
- 更新块内容blocks.delete
- 删除块
文档管理
documents.list
- 列出文档documents.create
- 创建文档documents.get
- 获取文档内容documents.update
- 更新文档
标签系统
tags.get_all
- 获取所有标签tags.search
- 搜索标签tags.manage
- 标签管理
高级功能
search.advanced
- 高级搜索search.recursive
- 递归搜索batch.operations
- 批量操作references.analyze
- 引用分析
🤝 贡献指南
欢迎贡献代码、报告问题或提出改进建议。
📄 许可证
MIT License - 详见 文件
🙏 致谢
感谢思源笔记团队提供优秀的笔记软件和 API 支持。