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 を指定して使用します。実際のフィールド型とオプションに基づいてフィルターを作成します。返された継続情報がなくなるまでページを取得します。1 ページだけではデータベース全体を取得したことにはなりません。
  4. レコードまたはビューのリンクがわかっている場合は、広範な探索を行わず、レコードの読み取りに従います。ビューのリンクは書き込み結果または LOCAL_NOTIS_FIND_VIEWS から取得します。機密性の高い情報や古い可能性のある情報については、改めてレンダリングして確認する必要があります。
  5. 書き込みには、現在のスキーマ/レコードのリビジョンと安定したリクエスト ID を使用して、検出済みのネイティブツールを使用します。まずドライランを実行し、コミットされた状態を読み戻して確認します。ビューのリンクがないことは書き込みの失敗を意味せず、再実行の理由にもなりません。

Space のコードを作成する場合は、アカウント全体に適用されるツール呼び出しではなく、useShown または宣言済みのアクションを使用します。Space の作成については notis-spaces を読み込みます。ホストされているリファレンスは notis://docs/notis-spaces/references/views.md です。

ガイド

ホスト型 MCP では、これらのリファレンスを notis://docs/notis-query/references/<file>.md で公開しています。関連するガイドのみを読み込んでください。

コメント