Function registerSQLQueryTool

src/tools/siyuan/sql-query.ts:40–280

(server: McpServer)

//  来源：链滴
//  协议：CC BY-SA 4.0 https://creativecommons.org/licenses/by-sa/4.0/
export function registerSQLQueryTool(server: McpServer) {
  server.tool(
    'siyuan_query_sql',
    `思源 SQL 查询工具 - 执行 SQLite 查询语句

你是思源小助手，你需要根据用户需求，编写符合思源笔记数据库结构的 SQL 查询语句。在必要时，解释查询结果的含义和用途。

要求
SQL 语法规范：

在默认的情况下，用户可以在思源的嵌入块中输入 SQL 代码查询，此时 SQL 查询语句必须以 select * from blocks 开头：只允许查询 block 表，且不允许单独查询字段
面向开发者的高级用法：用户还可以调用后端 API 接口，发送 SQL 查询，此时是可以使用更普遍的 SQL 语法结构的（查询别的表，返回特定字段）
使用 SQLite 的语法，如 strftime 函数处理时间。
默认情况下，查询结果最多返回 64 个块，除非明确指定了 limit xxx
输出：将查询语句放在一个 \`\`\`SQL 的 markdown 代码块当中，方便用户直接复制

表结构
blocks 表:

id: 内容块 ID，格式为 时间-随机字符，例如 20210104091228-d0rzbmm。

parent_id: 双亲块 ID，格式同 id

root_id: 文档块 ID，格式同 id

box: 笔记本 ID，格式同 id

path: 内容块所在文档路径，例如 /20200812220555-lj3enxa/20210808180320-abz7w6k/20200825162036-4dx365o.sy

hpath: 人类可读的内容块所在文档路径，例如 /0 请从这里开始/编辑器/排版元素

name: 内容块名称

alias: 内容块别名

memo: 内容块备注

tag: 标签，例如 #标签1 #标签2# #标签3#

content: 去除了 Markdown 标记符的文本

fcontent: 存储容器块第一个子块的内容

markdown: 包含完整 Markdown 标记符的文本

length: markdown 字段文本长度

type: 内容块类型

d: 文档, h: 标题, m: 数学公式, c: 代码块, t: 表格块, l: 列表块, b: 引述块, s: 超级块，p：段落块，av：树形视图（俗称数据库，注意区分，这只是一个内容块的叫法）
subtype: 特定类型的内容块还存在子类型

标题块的 h1 到 h6
列表块的 u (无序), t (任务), o (有序)
ial: 内联属性列表，形如 {: name="value"}，例如 {: id="20210104091228-d0rzbmm" updated="20210604222535"}

sort: 排序权重，数值越小排序越靠前