ukagaka-doc-mcp 0.2.8 → 0.2.10

package/data/index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-08-31T09:48:51.964Z",
+  "generatedAt": "2026-09-07T10:07:24.191Z",
   "entries": [
     {
       "id": "ukadoc:descript_balloon:charset_2c_6587_5b57_30b3_30fc_30c9:1",
@@ -9503,7 +9503,7 @@
       "title": "OnWallpaperChange",
       "source": "ukadoc",
       "category": "shiori_event",
-      "content": "OnWallpaperChange\n画像ファイルのDnDによって壁紙が変更された際に発生。\n\t\t\t\t\t\n\t\t\t\t\t\tReference0\n\t\t\t\t\t\tドロップされたファイルパス。",
+      "content": "OnWallpaperChange\n画像ファイルのDnDによって壁紙が変更された際に発生。\n\t\t\t\t\tOS側で壁紙が変更されたことの通知はOnDesktopWallpaperChange。\n\t\t\t\t\t\n\t\t\t\t\t\tReference0\n\t\t\t\t\t\tドロップされたファイルパス。\n\t\t\t\t\t\tReference1\n\t\t\t\t\t\t※SSPのみ　ドロップされたキャラクターのスコープ番号。(本体側0,相方1...)",
       "url": "https://ssp.shillest.net/ukadoc/manual/list_shiori_event.html#OnWallpaperChange:1"
     },
     {
@@ -10394,6 +10394,14 @@
       "content": "OnDarkTheme\nOSがダークテーマ(暗めの表示)に切り替えられた際に発生。\n\t\t\t\t\t起動直後にNOTIFY(喋れない)で通知され、切り替わった時にGET(喋れる)で通知される。\n\t\t\t\t\t\n\t\t\t\t\t\tReference0\n\t\t\t\t\t\t0/1：アプリ設定 1がダークテーマ、0が通常（明るい）テーマ\n\t\t\t\t\t\tReference1\n\t\t\t\t\t\t0/1：システム設定 1がダークテーマ、0が通常（明るい）テーマ (2.6.29)\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t 2.5.02",
       "url": "https://ssp.shillest.net/ukadoc/manual/list_shiori_event.html#OnDarkTheme:1"
     },
+    {
+      "id": "ukadoc:list_shiori_event:OnDesktopWallpaperChange:1",
+      "title": "OnDesktopWallpaperChange",
+      "source": "ukadoc",
+      "category": "shiori_event",
+      "content": "OnDesktopWallpaperChange\nOS側でデスクトップの壁紙が変更された際に発生。[起動時NOTIFY/他GET]\n\t\t\t\t\t利用者が個人用設定などで壁紙を変えた場合のほか、スライドショーやWindowsスポットライトによる自動的な差し替え、テーマの切り替えでも発生する。\n\t\t\t\t\tスライドショーとスポットライトは最短1分間隔で自動的に切り替わるため、この2つがきっかけの場合は起動後であってもNOTIFY(喋れない)で通知される。\n\t\t\t\t\t画像ファイルのDnDによって壁紙を変更した際のOnWallpaperChangeとは別のイベントで、SSP自身が壁紙を変更した場合(Reference1がself)には両方が発生する。両方に反応する場合は二重にならないよう注意。\n\t\t\t\t\t\n\t\t\t\t\t\tReference0\n\t\t\t\t\t\tinit (起動時通知) か update (起動後の変更)\n\t\t\t\t\t\tReference1\n\t\t\t\t\t\t変更のきっかけ。\n\t\t\t\t\t\tuser：利用者が変更した\n\t\t\t\t\t\tslideshow：スライドショーの自動送り\n\t\t\t\t\t\tspotlight：Windowsスポットライトの自動更新\n\t\t\t\t\t\ttheme：テーマの切り替えに伴うもの\n\t\t\t\t\t\tself：SSP自身が変更した(画像のDnD・プロファイルからの復元)\n\t\t\t\t\t\tunknown：変更されたことは確かだが、きっかけが判別できない\n\t\t\t\t\t\tReference2\n\t\t\t\t\t\t現在の壁紙画像のフルパス。単色背景の場合や取得できなかった場合は空。\n\t\t\t\t\t\tWindowsの仕様上、利用者が選んだ元の画像ファイルではなく、OSが作成したキャッシュ(TranscodedWallpaperやスポットライトのキャッシュ)のパスになることがある。\n\t\t\t\t\t\tReference3\n\t\t\t\t\t\t直前の壁紙画像のフルパス。Reference0がinitの場合は空。\n\t\t\t\t\t\tReference4\n\t\t\t\t\t\t表示スタイル。center / tile / stretch / fit / fill / span のいずれか。\n\t\t\t\t\t\tReference5\n\t\t\t\t\t\tデスクトップの背景色。壁紙の余白に出る色。R,G,B の半角カンマ区切り。\n\t\t\t\t\t\tReference6～\n\t\t\t\t\t\tモニタごとの壁紙情報が以下のフォーマットでモニタの数だけ後ろに続く。[\\1]はバイト値1。\n\t\t\t\t\t\tモニタ番号[\\1]壁紙画像のフルパス[\\1]表示スタイル\n\t\t\t\t\t\tモニタ番号はOnDisplayChangeExのReference1～の並び順と対応する(Reference1がモニタ番号0)。\n\t\t\t\t\t\t表示スタイルはOSがモニタごとに保持していないため、現状はすべて同じ値(Reference4と同一)になる。\n\t\t\t\t\t\tモニタごとの壁紙を扱えない環境(Windows 7以前)ではReference6以降は付かない。\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t 2.8.86",
+      "url": "https://ssp.shillest.net/ukadoc/manual/list_shiori_event.html#OnDesktopWallpaperChange:1"
+    },
     {
       "id": "ukadoc:list_shiori_event:OnOSUpdateInfo:1",
       "title": "OnOSUpdateInfo",
@@ -22650,14 +22658,6 @@
       "content": "どのイベントを使うのか？\n…といってもシェル名の取得と違ってタイミングは少ないので、下記のようにしておくだけで困ることはないでしょう。\nすぐに値を更新したい時は上記のプロパティシステムがおすすめ。\n＊OnNotifyBalloonInfo\n＄現在のバルーン【タブ】（Ｒ０）\n\n＊OnBalloonChange\n＄現在のバルーン【タブ】（Ｒ０）",
       "url": "https://soliton.sub.jp/satori/?%E7%8F%BE%E5%9C%A8%E3%81%AE%E3%83%90%E3%83%AB%E3%83%BC%E3%83%B3%E5%90%8D%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B#j06ef900"
     },
-    {
-      "id": "satori:月齢を計算する#vd8a3418",
-      "title": "月齢を計算する - 月齢",
-      "source": "satori_wiki",
-      "category": "satori_tips",
-      "content": "月齢\n月齢の計算式を里々に当てはめたもの。正確な月齢を得るには複雑な計算式が必要であるため、かなり簡素化されている。精度は劣るものの記述が簡単なのがメリット。\n使い方は（月齢）。実行時の年月日で算出される。\n＠月齢\n（calc,\n（（（（現在年）-11）%19）*11 +（nswitch,（現在月）,0,2,0,2,2,4,5,6,7,8,9,10）+（現在日））%30\n）\n特定の日付の月齢を得たい場合は関数化する。\n＠月齢\n（calc,\n（（（（Ａ０）-11）%19）*11 +（nswitch,（Ａ１）,0,2,0,2,2,4,5,6,7,8,9,10）+（Ａ２））%30\n）\n\n＊\n：２０１６年１月１日の月齢は（call,月齢,２０１６,１,１）だよ。",
-      "url": "https://soliton.sub.jp/satori/?%E6%9C%88%E9%BD%A2%E3%82%92%E8%A8%88%E7%AE%97%E3%81%99%E3%82%8B#vd8a3418"
-    },
     {
       "id": "satori:スライダーもどき#v6253498",
       "title": "スライダーもどき - スライダーもどき",

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAW/D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAyBvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAW/D"}

package/dist/server.js

@@ -13,10 +13,11 @@ import { registerSearchDocsTool } from './tools/search-docs.js';
 const SERVER_INSTRUCTIONS = `\
 このサーバーは伺か（Ukagaka）の技術ドキュメントを検索します。
 
-3つのソースからドキュメントを提供します:
+4つのソースからドキュメントを提供します:
 - UKADOC: SSP公式仕様書（さくらスクリプト、SHIORIイベント、設定ファイル仕様、プロトコル規格）
 - YAYA Wiki: YAYA SHIORIの文法、組み込み関数、実践Tips
 - 里々Wiki: 里々SHIORIの構文、変数、関数、独自イベント、Tips
+- 蒼空(Aosora) Wiki: 蒼空スクリプトの文法、組み込み機能、発展的トピック
 
 推奨ワークフロー:
 1. list_categories でカテゴリ一覧を確認
@@ -25,6 +26,8 @@ const SERVER_INSTRUCTIONS = `\
 
 注意事項:
 - ビルド時点のドキュメントスナップショットを検索します
+- インデックスはページ/セクション単位。タイトルは "OnBoot" "\\q[タイトル,ID]" "charset,文字コード" のような原文の見出しがそのまま入っています
+- search_docs の query は単語1つだけ（空白区切りの複数語・自然文は0件になる）。絞り込みは category / source で行ってください
 - さくらスクリプトのタグ検索: \\s0 のように入力（バックスラッシュはそのまま）`;
 export function createMcpServer(engine) {
     const server = new McpServer({ name: 'ukagaka-doc-mcp', version: '0.1.0' }, { instructions: SERVER_INSTRUCTIONS });

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;4CAegB,CAAC;AAE7C,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC7C,EAAE,YAAY,EAAE,mBAAmB,EAAE,CACtC,CAAC;IAEF,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;4CAkBgB,CAAC;AAE7C,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC7C,EAAE,YAAY,EAAE,mBAAmB,EAAE,CACtC,CAAC;IAEF,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/search-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8CpF"}
+{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwDpF"}

package/dist/tools/search-docs.js

@@ -2,8 +2,16 @@ import { z } from 'zod';
 import { CATEGORIES, SOURCE_VALUES } from '../constants.js';
 const CATEGORY_KEYS = Object.keys(CATEGORIES);
 export function registerSearchDocsTool(server, engine) {
-    server.tool('search_docs', '伺か・YAYA・里々・蒼空の技術ドキュメントをキーワード検索する。要約（500文字）を返す。詳細は get_doc で取得。', {
-        query: z.string().min(1).describe('検索キーワード'),
+    // NOTE: ツール description は OpenAI 系クライアント（MCP→function calling ブリッジ）で
+    // 1024文字を超えると 400 で弾かれる。詳しい指定スタイルは query の describe 側に置くこと
+    // （パラメータの description には同様の上限が観測されていない）。
+    server.tool('search_docs', '伺か・YAYA・里々・蒼空の技術ドキュメントをキーワード検索する。要約（500文字）を返す。詳細は get_doc で取得。'
+        + 'query は単語1つのみ（空白区切りや自然文は0件になる）。', {
+        query: z.string().min(1).describe(`検索語。クエリ全体を1個の部分文字列として照合する単純検索（部分一致/大小無視）。分かち書き・AND/OR無し。
+OK: "OnBoot" "選択肢" "REPLACE" "\\q" "surfaces.txt" ／ NG: "文字列 置換" "さくらスクリプトで選択肢を出す方法" "choice"
+- 識別子・タグは原文表記のまま（さくらスクリプトは "\\q" のようにバックスラッシュ付き）
+- 日本語で引き、助詞や修飾は落として名詞の核だけにする（"変数のスコープ"→"スコープ"）
+- 絞り込みは語を足さず category / source を使う。0件なら短い語に分解して引き直す`),
         category: z.enum(CATEGORY_KEYS).optional()
             .describe('カテゴリで絞り込み（list_categories で確認可能）'),
         source: z.enum(SOURCE_VALUES).optional()

package/dist/tools/search-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG5D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAe,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAoB;IAC5E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,gEAAgE,EAChE;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC5C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,aAA0C,CAAC,CAAC,QAAQ,EAAE;aACpE,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;aACrC,QAAQ,CAAC,0DAA0D,CAAC;QACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;aAC/C,QAAQ,CAAC,uBAAuB,CAAC;KACrC,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;YAC9C,QAAQ,EAAE,QAAgC;YAC1C,MAAM,EAAE,MAA4B;YACpC,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,WAAW;4BACnB,OAAO,EAAE,IAAI,KAAK,0BAA0B;4BAC5C,KAAK,EAAE,CAAC;yBACT,CAAC;qBACH,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM,EAAE,IAAI;wBACZ,KAAK;wBACL,OAAO,EAAE,OAAO,CAAC,MAAM;wBACvB,IAAI,EAAE,OAAO;qBACd,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG5D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAe,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAoB;IAC5E,qEAAqE;IACrE,2DAA2D;IAC3D,yCAAyC;IACzC,MAAM,CAAC,IAAI,CACT,aAAa,EACb,gEAAgE;UAC5D,iCAAiC,EACrC;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC/B;;;;oDAI4C,CAC7C;QACD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,aAA0C,CAAC,CAAC,QAAQ,EAAE;aACpE,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;aACrC,QAAQ,CAAC,0DAA0D,CAAC;QACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;aAC/C,QAAQ,CAAC,uBAAuB,CAAC;KACrC,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;YAC9C,QAAQ,EAAE,QAAgC;YAC1C,MAAM,EAAE,MAA4B;YACpC,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,WAAW;4BACnB,OAAO,EAAE,IAAI,KAAK,0BAA0B;4BAC5C,KAAK,EAAE,CAAC;yBACT,CAAC;qBACH,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM,EAAE,IAAI;wBACZ,KAAK;wBACL,OAAO,EAAE,OAAO,CAAC,MAAM;wBACvB,IAAI,EAAE,OAAO;qBACd,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ukagaka-doc-mcp",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "MCP server for searching Ukagaka (伺か) technical documentation: UKADOC, YAYA Wiki, 里々Wiki, and 蒼空(aosora) Wiki",
   "keywords": [
     "mcp",