{"repo":"xgq18237/siyuan_mcp_server","free":true,"listed":false,"github":"https://github.com/xgq18237/siyuan_mcp_server","clone":"git clone https://github.com/xgq18237/siyuan_mcp_server.git","description":"思源笔记MCP / SiYuan MCP Server","language":"TypeScript","stars":71,"topics":[],"license":"MIT","category":"mcp-servers","readme_excerpt":"🧠 SiYuan MCP Server 简体中文 English 让 Claude、Cursor、Codex 等 AI 客户端安全地读取和操作思源笔记。 siyuan-mcp 是一个基于 Model Context Protocol 的思源笔记 MCP 服务器。它通过思源 Kernel API 提供笔记本、文档、内容块、全文搜索、原生数据库、资源文件和导出等能力，并针对 AI 自动化场景增加了结构化返回、安全注解与默认防护。 当前版本： 1.1.1 --- ✨ 核心亮点 能力 说明 --- --- 📚 笔记本与文档 创建、浏览、搜索、重命名、移动和删除 🧱 内容块 Markdown/DOM 插入、更新、移动、折叠、引用和批量操作 🔎 搜索 文档标题搜索、全文块搜索和 SQL 查询 🗃️ 原生数据库 创建 AV 数据库、字段、条目、单元格和批量更新 📎 文件与资源 Multipart 上传、工作空间文件读写和二进制 Base64 返回 🧩 模板与转换 Template、Sprig、Pandoc、Markdown 和资源导出 🛡️ 可选防护 删除类操作保护开关、路径白名单和响应上限 🤖 MCP 友好 structuredContent 、 isError 、工具安全注解和纯净 stdio 项目目前提供约 69 个面向 AI 使用场景设计的工具。它选择性封装稳定且实用的思源接口，不追求暴露全部内核私有 API。 🧭 工作原理 所有调试信息只写入 stderr ， stdout 始终保留给 MCP JSON-RPC，避免客户端因混入普通日志而断开连接。 --- 🚀 快速开始 🤖 让智能体自动配置 只需复制下面的提示词，并填写 MCP 客户端和思源 Token。默认连接本机 127.0.0.1:6806 ；使用其他地址时再修改 HOST 和 PORT。 1. 准备环境 - Node.js = 18 - 已启动的思源笔记 - 思源 API Token API Token 获取位置： 思源笔记 → 设置 → 关于 → API Token 2. 使用 npx 启动 MCP 服务器通常由 AI 客户端自动启动，不需要单独打开终端常驻运行。 3. 配置 MCP 客户端 该配置形式可用于 Cursor、Claude Desktop 以及其他支持 stdio MCP 的客户端。不同客户端的配置文件位置可能不同，但 command 、 args 和 env 内容基本一致。 为兼容旧版配置，推荐继续使用 SIYUAN HOST 、 SIYUAN PORT 和 SIYUAN TOKEN 。连接远程实例、反向代理或带路径前缀的实例时，可以使用 SIYUAN URL 覆盖 HOST/PORT： 4. 验证连接 连接后可以让 AI 尝试： 或者直接调用： - check siyuan status - list notebooks - get version --- 🧰 功能地图 📚 笔记本 工具 用途 --- --- list notebooks 列出所有笔记本及打开状态 create notebook 创建笔记本 open notebook / close notebook 打开或关闭笔记本 rename notebook 重命名笔记本 get notebook conf / set notebook conf 读取或保存配置 remove notebook 删除笔记本，属于危险操作 📄 文档与文档树 工具 用途 --- --- create do","default_branch":null,"files":null,"tree":[],"storefront":"/r/xgq18237","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/xgq18237/siyuan_mcp_server/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}