mcpField
N
notis-query

notis-query

github.com/mindtheflo数据与数据库0177 次安装今天更新
代码仓库

关于 notis-query

notis-query 是使用 Notis 原生结构化查询访问数据库的技能,可帮助检查架构、获取完整分页结果,并通过版本校验安全处理记录和写入。

主要功能

  1. 01检查数据库架构与目标
  2. 02筛选、排序、聚合和分页
  3. 03查询至所有分页完成
  4. 04读取关联记录和视图
  5. 05通过版本校验与回读保障写入

适用场景

  1. 01查找符合字段条件的记录
  2. 02计算数量或聚合值
  3. 03获取数据库查询的全部分页
  4. 04更新记录并核验结果

MCP 相关

该技能说明如何使用 Notis 原生数据库工具,包括数据库发现、查询和写入操作。托管 MCP 提供相关参考指南。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mindtheflo/notis-skills --skill notis-query

安装后在 Claude Code 中输入/notis-query确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
database-discovery.md
documents.md
query.md

详细介绍

原生数据库查询

使用结构化原生查询进行筛选、排序、计数、聚合和分页。使用记忆进行语义发现;使用视图渲染查看页面显示的内容。实时工具 inputSchema 具有权威性。

  1. 使用 LOCAL_NOTIS_DATABASE_GET_DATABASE 发现数据库,并检查其架构、属性描述、关联目标和选项 ID。
  2. 保留其返回的确切原生 target、架构修订版本和可用操作。每个数据库都位于一个 Space 中;访问失败时不会回退到其他所有者。
  3. 使用 LOCAL_NOTIS_DATABASE_QUERY,并传入 protocol: 1、该 target 和直接的 input。根据实际字段类型和选项构建筛选条件。持续翻页,直到返回的续页标记结束;一页并不代表整个数据库。
  4. 对于已知记录或视图链接,请遵循读取记录,而不是进行宽泛的发现。视图链接来自写入结果或 LOCAL_NOTIS_FIND_VIEWS;对于敏感或过时的证据,需要重新渲染以获取最新内容。
  5. 写入时使用已发现的原生工具,并提供当前架构/记录修订版本和稳定的请求 ID。先进行试运行,再读取已提交的状态。缺少视图链接不代表写入失败,也不能据此重复写入。

在编写 Space 代码时,使用 useShown 或已声明的操作,而不是调用账户范围的工具。加载 notis-spaces 以查看 Space 编写指南;其托管版参考文档位于 notis://docs/notis-spaces/references/views.md。

指南

托管版 MCP 会将这些参考文档放在 notis://docs/notis-query/references/<file>.md 下;只加载相关指南。

评论

支持 Markdown