ukagaka-doc-mcp 0.2.8 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +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;
|
|
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;AAyBvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAW/D"}
|
package/dist/server.js
CHANGED
|
@@ -13,10 +13,11 @@ import { registerSearchDocsTool } from './tools/search-docs.js';
|
|
|
13
13
|
const SERVER_INSTRUCTIONS = `\
|
|
14
14
|
このサーバーは伺か（Ukagaka）の技術ドキュメントを検索します。
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
4つのソースからドキュメントを提供します:
|
|
17
17
|
- UKADOC: SSP公式仕様書（さくらスクリプト、SHIORIイベント、設定ファイル仕様、プロトコル規格）
|
|
18
18
|
- YAYA Wiki: YAYA SHIORIの文法、組み込み関数、実践Tips
|
|
19
19
|
- 里々Wiki: 里々SHIORIの構文、変数、関数、独自イベント、Tips
|
|
20
|
+
- 蒼空(Aosora) Wiki: 蒼空スクリプトの文法、組み込み機能、発展的トピック
|
|
20
21
|
|
|
21
22
|
推奨ワークフロー:
|
|
22
23
|
1. list_categories でカテゴリ一覧を確認
|
|
@@ -25,6 +26,8 @@ const SERVER_INSTRUCTIONS = `\
|
|
|
25
26
|
|
|
26
27
|
注意事項:
|
|
27
28
|
- ビルド時点のドキュメントスナップショットを検索します
|
|
29
|
+
- インデックスはページ/セクション単位。タイトルは "OnBoot" "\\q[タイトル,ID]" "charset,文字コード" のような原文の見出しがそのまま入っています
|
|
30
|
+
- search_docs の query は単語1つだけ（空白区切りの複数語・自然文は0件になる）。絞り込みは category / source で行ってください
|
|
28
31
|
- さくらスクリプトのタグ検索: \\s0 のように入力（バックスラッシュはそのまま）`;
|
|
29
32
|
export function createMcpServer(engine) {
|
|
30
33
|
const server = new McpServer({ name: 'ukagaka-doc-mcp', version: '0.1.0' }, { instructions: SERVER_INSTRUCTIONS });
|
package/dist/server.js.map
CHANGED
|
@@ -1 +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
|
|
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;;;;;;;;;;;;;;;;;;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"}
|
|
@@ -1 +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,
|
|
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,CAwDpF"}
|
|
@@ -2,8 +2,16 @@ import { z } from 'zod';
|
|
|
2
2
|
import { CATEGORIES, SOURCE_VALUES } from '../constants.js';
|
|
3
3
|
const CATEGORY_KEYS = Object.keys(CATEGORIES);
|
|
4
4
|
export function registerSearchDocsTool(server, engine) {
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
// NOTE: ツール description は OpenAI 系クライアント（MCP→function calling ブリッジ）で
|
|
6
|
+
// 1024文字を超えると 400 で弾かれる。詳しい指定スタイルは query の describe 側に置くこと
|
|
7
|
+
// （パラメータの description には同様の上限が観測されていない）。
|
|
8
|
+
server.tool('search_docs', '伺か・YAYA・里々・蒼空の技術ドキュメントをキーワード検索する。要約（500文字）を返す。詳細は get_doc で取得。'
|
|
9
|
+
+ 'query は単語1つのみ（空白区切りや自然文は0件になる）。', {
|
|
10
|
+
query: z.string().min(1).describe(`検索語。クエリ全体を1個の部分文字列として照合する単純検索（部分一致/大小無視）。分かち書き・AND/OR無し。
|
|
11
|
+
OK: "OnBoot" "選択肢" "REPLACE" "\\q" "surfaces.txt" ／ NG: "文字列 置換" "さくらスクリプトで選択肢を出す方法" "choice"
|
|
12
|
+
- 識別子・タグは原文表記のまま（さくらスクリプトは "\\q" のようにバックスラッシュ付き）
|
|
13
|
+
- 日本語で引き、助詞や修飾は落として名詞の核だけにする（"変数のスコープ"→"スコープ"）
|
|
14
|
+
- 絞り込みは語を足さず category / source を使う。0件なら短い語に分解して引き直す`),
|
|
7
15
|
category: z.enum(CATEGORY_KEYS).optional()
|
|
8
16
|
.describe('カテゴリで絞り込み（list_categories で確認可能）'),
|
|
9
17
|
source: z.enum(SOURCE_VALUES).optional()
|
|
@@ -1 +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,
|
|
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,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"}
|