ukagaka-doc-mcp 0.1.0

package/dist/parser/yaya-scraper.js

@@ -0,0 +1,308 @@
+/**
+ * YAYA Wiki スクレイパー
+ *
+ * https://emily.shillest.net/ayaya/ (PukiWiki Plus!)
+ *
+ * 設計方針:
+ * - YAYA関数ページ（マニュアル/関数/*）は1ページ=1エントリ（情報断片化防止）
+ * - その他のページはセクション(h2/h3)単位で分割
+ * - レート制限: 500ms/リクエスト
+ */
+import { SCRAPE_RATE_LIMIT_MS } from '../constants.js';
+import * as cheerio from 'cheerio';
+const BASE_URL = 'https://emily.shillest.net/ayaya/';
+const INVALID_PAGE_MARKERS = ['有効なWikiNameではありません'];
+/** スクレイプ対象ページ一覧。ビルド時に動的取得するページのベース。 */
+export const YAYA_STATIC_PAGES = [
+    // -- マニュアル/文法 --
+    { path: 'マニュアル/文法/基礎設定', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/関数定義', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/変数', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/演算', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/配列', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/フロー制御', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/プリプロセッサ', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/予約語', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/DLL仕様', category: 'yaya_grammar' },
+    { path: 'マニュアル/文法/文字コード', category: 'yaya_grammar' },
+    // -- マニュアル/基本 --
+    { path: 'マニュアル/基本/変数', category: 'yaya_basic' },
+    { path: 'マニュアル/基本/関数', category: 'yaya_basic' },
+    { path: 'マニュアル/基本/条件分岐', category: 'yaya_basic' },
+    { path: 'マニュアル/基本/ループ', category: 'yaya_basic' },
+    { path: 'マニュアル/基本/配列', category: 'yaya_basic' },
+    { path: 'マニュアル/基本/演算子', category: 'yaya_basic' },
+    // -- システム辞書 --
+    { path: 'システム辞書', category: 'yaya_system' },
+    { path: 'システム辞書/yaya_shiori3.dic', category: 'yaya_system' },
+    { path: 'システム辞書/yaya_optional.dic', category: 'yaya_system' },
+    // -- StartUp --
+    { path: 'StartUp', category: 'yaya_startup' },
+    { path: 'StartUp/YAYAでゴーストを作る', category: 'yaya_startup' },
+    { path: 'StartUp/AYAからの移行', category: 'yaya_startup' },
+    { path: 'StartUp/里々からの移行', category: 'yaya_startup' },
+    // -- SAORI/MAKOTO/PLUGIN --
+    { path: 'YAYA as SAORI', category: 'yaya_grammar' },
+    { path: 'YAYA as MAKOTO', category: 'yaya_grammar' },
+    { path: 'YAYA as PLUGIN', category: 'yaya_grammar' },
+];
+/** 関数ページのプレフィックス */
+export const YAYA_FUNCTION_PAGE_PREFIX = 'マニュアル/関数/';
+/** Tipsページのプレフィックス */
+export const YAYA_TIPS_PAGE_PREFIX = 'Tips/';
+// ============================================================
+// HTTP取得
+// ============================================================
+async function fetchPageHtml(pagePath) {
+    const encodedPath = encodePagePath(pagePath);
+    const url = `${BASE_URL}?${encodedPath}`;
+    try {
+        const res = await fetch(url, {
+            headers: {
+                'User-Agent': 'ukagaka-doc-mcp/0.1 (index builder; +https://github.com/)',
+                'Accept': 'text/html',
+            },
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!res.ok) {
+            console.error(`[yaya-scraper] HTTP ${res.status} for ${url}`);
+            return null;
+        }
+        return await res.text();
+    }
+    catch (err) {
+        console.error(`[yaya-scraper] Failed to fetch ${url}:`, err);
+        return null;
+    }
+}
+function encodePagePath(pagePath) {
+    // PukiWikiのURLは各セグメントを%エンコード（/ はそのまま）
+    return pagePath.split('/').map(encodeURIComponent).join('/');
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ============================================================
+// HTMLパース
+// ============================================================
+/**
+ * PukiWiki のHTMLからコンテンツ本文を抽出し、DocEntry を生成する。
+ *
+ * @param html      取得したHTML
+ * @param pagePath  Wikiページパス（canonical_id生成に使用）
+ * @param category  カテゴリ
+ * @param onePageOneEntry  true の場合はセクション分割せず1エントリにする
+ */
+export function parseYayaPage(html, pagePath, category, onePageOneEntry = false) {
+    const $ = cheerio.load(html);
+    const pageUrl = `${BASE_URL}?${encodePagePath(pagePath)}`;
+    // ナビゲーション・ヘッダー・フッターを除去
+    $('#menu, #menubar, #navi, .navi, #footer, #toolbar, form').remove();
+    $('script, style').remove();
+    const pageTitle = $('#page-title, h1').first().text().trim() || pagePath.split('/').pop() || pagePath;
+    // コンテンツ領域を取得（PukiWiki の #content または body）
+    const $content = $('#content, #body, .body').first();
+    const $root = $content.length ? $content : $('body');
+    if (isInvalidWikiPage(pageTitle, extractText($root.text()))) {
+        return [];
+    }
+    if (onePageOneEntry) {
+        // 関数ページ: 1ページ=1エントリ
+        const content = extractText($root.text());
+        return [{
+                id: `yaya:${pagePath}`,
+                title: pageTitle,
+                source: 'yaya_wiki',
+                category,
+                content,
+                url: pageUrl,
+            }];
+    }
+    // セクション(h2/h3)単位で分割
+    const entries = [];
+    const headers = $root.find('h2, h3');
+    if (headers.length === 0) {
+        // セクションなし: 1エントリ
+        const content = extractText($root.text());
+        if (content.trim()) {
+            entries.push({
+                id: `yaya:${pagePath}`,
+                title: pageTitle,
+                source: 'yaya_wiki',
+                category,
+                content,
+                url: pageUrl,
+            });
+        }
+        return entries;
+    }
+    headers.each((_, header) => {
+        const $header = $(header);
+        const sectionTitle = $header.text().replace(/[†¶#]/g, '').trim();
+        if (!sectionTitle)
+            return;
+        const anchor = $header.attr('id') || slugify(sectionTitle);
+        const parts = [sectionTitle];
+        let $sibling = $header.next();
+        while ($sibling.length && !$sibling.is('h2, h3')) {
+            const text = $sibling.text().trim();
+            if (text)
+                parts.push(text);
+            $sibling = $sibling.next();
+        }
+        const content = parts.join('\n');
+        if (content.trim().length < 10)
+            return;
+        entries.push({
+            id: `yaya:${pagePath}#${anchor}`,
+            title: `${pageTitle} - ${sectionTitle}`,
+            source: 'yaya_wiki',
+            category,
+            content,
+            url: `${pageUrl}#${anchor}`,
+        });
+    });
+    return entries;
+}
+// ============================================================
+// ページ一覧取得（関数一覧・Tips一覧）
+// ============================================================
+/**
+ * YAYA Wiki の関数一覧ページから個別関数ページのリストを取得する。
+ */
+export async function fetchYayaFunctionPageList() {
+    // マニュアル/関数 の一覧ページを取得してリンクを収集
+    const indexPages = ['マニュアル/関数'];
+    const functionPages = [];
+    for (const indexPage of indexPages) {
+        const html = await fetchPageHtml(indexPage);
+        if (!html)
+            continue;
+        const $ = cheerio.load(html);
+        $('#content a, #body a, .body a').each((_, a) => {
+            const href = normalizeYayaWikiHref($(a).attr('href'));
+            // ?マニュアル/関数/XXX 形式のリンクを収集
+            if (href?.startsWith('?') && !isMetaWikiHref(href) && href.includes('%E3%83%9E%E3%83%8B%E3%83%A5%E3%82%A2%E3%83%AB')) {
+                try {
+                    const pagePath = decodeURIComponent(href.slice(1));
+                    if (pagePath.startsWith(YAYA_FUNCTION_PAGE_PREFIX) && pagePath !== YAYA_FUNCTION_PAGE_PREFIX) {
+                        functionPages.push(pagePath);
+                    }
+                }
+                catch {
+                    // デコード失敗は無視
+                }
+            }
+        });
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    return [...new Set(functionPages)]; // 重複除去
+}
+/**
+ * YAYA Wiki の Tips 一覧ページから個別Tipsページのリストを取得する。
+ */
+export async function fetchYayaTipsPageList() {
+    const tipsPages = [];
+    const html = await fetchPageHtml('Tips');
+    if (!html)
+        return tipsPages;
+    const $ = cheerio.load(html);
+    $('#content a, #body a').each((_, a) => {
+        const href = normalizeYayaWikiHref($(a).attr('href'));
+        if (href?.startsWith('?') && !isMetaWikiHref(href)) {
+            try {
+                const pagePath = decodeURIComponent(href.slice(1));
+                if (pagePath.startsWith(YAYA_TIPS_PAGE_PREFIX)) {
+                    tipsPages.push(pagePath);
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+    });
+    await sleep(SCRAPE_RATE_LIMIT_MS);
+    return [...new Set(tipsPages)];
+}
+// ============================================================
+// メインスクレイプ関数
+// ============================================================
+/**
+ * YAYA Wiki全体をスクレイプして DocEntry[] を返す。
+ */
+export async function scrapeYayaWiki() {
+    const allEntries = [];
+    // 1. 静的ページ
+    console.error('[yaya-scraper] Scraping static pages...');
+    for (const pageDef of YAYA_STATIC_PAGES) {
+        const html = await fetchPageHtml(pageDef.path);
+        if (html) {
+            const entries = parseYayaPage(html, pageDef.path, pageDef.category, pageDef.onePageOneEntry);
+            allEntries.push(...entries);
+            console.error(`[yaya-scraper] ${pageDef.path}: ${entries.length} entries`);
+        }
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    // 2. 関数ページ（動的に一覧を取得）
+    console.error('[yaya-scraper] Fetching function page list...');
+    const functionPages = await fetchYayaFunctionPageList();
+    console.error(`[yaya-scraper] Found ${functionPages.length} function pages`);
+    for (const pagePath of functionPages) {
+        const html = await fetchPageHtml(pagePath);
+        if (html) {
+            // 関数ページは1ページ=1エントリ
+            const entries = parseYayaPage(html, pagePath, 'yaya_function', true);
+            allEntries.push(...entries);
+        }
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    // 3. Tips ページ（動的に一覧を取得）
+    console.error('[yaya-scraper] Fetching Tips page list...');
+    const tipsPages = await fetchYayaTipsPageList();
+    console.error(`[yaya-scraper] Found ${tipsPages.length} Tips pages`);
+    for (const pagePath of tipsPages) {
+        const html = await fetchPageHtml(pagePath);
+        if (html) {
+            const entries = parseYayaPage(html, pagePath, 'yaya_tips');
+            allEntries.push(...entries);
+        }
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    console.error(`[yaya-scraper] Total: ${allEntries.length} entries`);
+    return allEntries;
+}
+// ============================================================
+// ユーティリティ
+// ============================================================
+function extractText(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function slugify(text) {
+    return text
+        .replace(/[^\w\u3040-\u9FFF]/g, '_')
+        .replace(/_+/g, '_')
+        .slice(0, 64);
+}
+export function normalizeYayaWikiHref(href) {
+    if (!href) {
+        return null;
+    }
+    if (href.startsWith('#')) {
+        return null;
+    }
+    let normalized = href;
+    if (normalized.startsWith('./?')) {
+        normalized = normalized.slice(2);
+    }
+    if (!normalized.startsWith('?')) {
+        return null;
+    }
+    return normalized.split('#', 1)[0] || null;
+}
+function isMetaWikiHref(href) {
+    return href.startsWith('?cmd=') || href.startsWith('?plugin=');
+}
+function isInvalidWikiPage(pageTitle, bodyText) {
+    return INVALID_PAGE_MARKERS.some(marker => pageTitle.includes(marker) || bodyText.includes(marker));
+}
+//# sourceMappingURL=yaya-scraper.js.map

package/dist/parser/yaya-scraper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaya-scraper.js","sourceRoot":"","sources":["../../src/parser/yaya-scraper.ts"],"names":[],"mappings":"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"}

package/dist/search/engine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 検索エンジン
+ *
+ * インメモリ全文検索。起動時に DocEntry[] をロードして以後はメモリ内で検索する。
+ *
+ * 検索仕様:
+ * - 大文字小文字無視
+ * - 日本語・英語とも部分一致
+ * - バックスラッシュ正規化: \\s → \s（クエリとコンテンツ両方に適用）
+ * - スコアリング: タイトル完全一致 > タイトル部分一致 > 本文部分一致
+ */
+import type { DocEntry, SearchEntry, Source, Category } from '../types.js';
+export interface SearchOptions {
+    category?: Category;
+    source?: Source;
+    limit?: number;
+}
+export declare class SearchEngine {
+    private entries;
+    /**
+     * インデックスをロードする。起動時に1回呼ぶ。
+     */
+    load(entries: DocEntry[]): void;
+    /**
+     * インデックスにエントリをマージする（差分更新用。将来の拡張のため残す）。
+     */
+    merge(newEntries: DocEntry[]): void;
+    get size(): number;
+    /**
+     * id でエントリを1件取得する（get_doc ツール用）。
+     */
+    getById(id: string): DocEntry | undefined;
+    /**
+     * キーワード検索。SearchEntry（summary付き）のリストを返す。
+     */
+    search(query: string, opts?: SearchOptions): {
+        results: SearchEntry[];
+        total: number;
+    };
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/search/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/search/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA0C3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IAEjC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI;IAK/B;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAQnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG;QAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAgC3F"}

package/dist/search/engine.js

@@ -0,0 +1,114 @@
+/**
+ * 検索エンジン
+ *
+ * インメモリ全文検索。起動時に DocEntry[] をロードして以後はメモリ内で検索する。
+ *
+ * 検索仕様:
+ * - 大文字小文字無視
+ * - 日本語・英語とも部分一致
+ * - バックスラッシュ正規化: \\s → \s（クエリとコンテンツ両方に適用）
+ * - スコアリング: タイトル完全一致 > タイトル部分一致 > 本文部分一致
+ */
+import { buildSummary } from '../text.js';
+// ============================================================
+// 正規化
+// ============================================================
+function normalizeQuery(query) {
+    return query
+        // \\s → \s のような二重バックスラッシュを正規化
+        .replace(/\\\\/g, '\\')
+        .toLowerCase();
+}
+function normalizeContent(text) {
+    return text
+        .replace(/\\\\/g, '\\')
+        .toLowerCase();
+}
+// ============================================================
+// スコアリング
+// ============================================================
+const SCORE_TITLE_EXACT = 100;
+const SCORE_TITLE_PARTIAL = 50;
+const SCORE_CONTENT_MATCH = 10;
+function scoreEntry(entry, normalizedQuery) {
+    const title = normalizeContent(entry.title);
+    const content = normalizeContent(entry.content);
+    if (title === normalizedQuery)
+        return SCORE_TITLE_EXACT;
+    if (title.includes(normalizedQuery))
+        return SCORE_TITLE_PARTIAL;
+    if (content.includes(normalizedQuery))
+        return SCORE_CONTENT_MATCH;
+    return 0;
+}
+export class SearchEngine {
+    entries = [];
+    /**
+     * インデックスをロードする。起動時に1回呼ぶ。
+     */
+    load(entries) {
+        this.entries = entries;
+        console.error(`[search-engine] Loaded ${entries.length} entries`);
+    }
+    /**
+     * インデックスにエントリをマージする（差分更新用。将来の拡張のため残す）。
+     */
+    merge(newEntries) {
+        const idSet = new Set(newEntries.map(e => e.id));
+        this.entries = [
+            ...this.entries.filter(e => !idSet.has(e.id)),
+            ...newEntries,
+        ];
+    }
+    get size() {
+        return this.entries.length;
+    }
+    /**
+     * id でエントリを1件取得する（get_doc ツール用）。
+     */
+    getById(id) {
+        return this.entries.find(e => e.id === id);
+    }
+    /**
+     * キーワード検索。SearchEntry（summary付き）のリストを返す。
+     */
+    search(query, opts = {}) {
+        if (!query.trim()) {
+            return { results: [], total: 0 };
+        }
+        const normalizedQuery = normalizeQuery(query);
+        const limit = Math.min(opts.limit ?? 10, 50);
+        const scored = [];
+        for (const entry of this.entries) {
+            // ソースフィルタ
+            if (opts.source && entry.source !== opts.source)
+                continue;
+            // カテゴリフィルタ
+            if (opts.category && entry.category !== opts.category)
+                continue;
+            const score = scoreEntry(entry, normalizedQuery);
+            if (score > 0) {
+                scored.push({ entry, score });
+            }
+        }
+        // スコア降順 → id昇順（同スコア内の安定ソート）
+        scored.sort((a, b) => b.score - a.score || a.entry.id.localeCompare(b.entry.id));
+        const total = scored.length;
+        const results = scored.slice(0, limit).map(({ entry }) => toSearchEntry(entry));
+        return { results, total };
+    }
+}
+// ============================================================
+// DocEntry → SearchEntry 変換
+// ============================================================
+function toSearchEntry(entry) {
+    return {
+        id: entry.id,
+        title: entry.title,
+        source: entry.source,
+        category: entry.category,
+        summary: buildSummary(entry.content),
+        url: entry.url,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/search/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/search/engine.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCPサーバー定義
+ *
+ * createServer で3つのツールを登録する:
+ * 1. search_docs  - キーワード検索（summary返却）
+ * 2. get_doc      - 全文取得（id → DocEntry）
+ * 3. list_categories - カテゴリ一覧
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SearchEngine } from './search/engine.js';
+export declare function createMcpServer(engine: SearchEngine): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +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"}

package/dist/server.js

@@ -0,0 +1,36 @@
+/**
+ * MCPサーバー定義
+ *
+ * createServer で3つのツールを登録する:
+ * 1. search_docs  - キーワード検索（summary返却）
+ * 2. get_doc      - 全文取得（id → DocEntry）
+ * 3. list_categories - カテゴリ一覧
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerGetDocTool } from './tools/get-doc.js';
+import { registerListCategoriesTool } from './tools/list-categories.js';
+import { registerSearchDocsTool } from './tools/search-docs.js';
+const SERVER_INSTRUCTIONS = `\
+このサーバーは伺か（Ukagaka）の技術ドキュメントを検索します。
+
+3つのソースからドキュメントを提供します:
+- UKADOC: SSP公式仕様書（さくらスクリプト、SHIORIイベント、設定ファイル仕様、プロトコル規格）
+- YAYA Wiki: YAYA SHIORIの文法、組み込み関数、実践Tips
+- 里々Wiki: 里々SHIORIの構文、変数、関数、独自イベント、Tips
+
+推奨ワークフロー:
+1. list_categories でカテゴリ一覧を確認
+2. search_docs でキーワード検索（要約を返す）
+3. 詳細が必要なエントリは get_doc(id) で全文を取得
+
+注意事項:
+- ビルド時点のドキュメントスナップショットを検索します
+- さくらスクリプトのタグ検索: \\s0 のように入力（バックスラッシュはそのまま）`;
+export function createMcpServer(engine) {
+    const server = new McpServer({ name: 'ukagaka-doc-mcp', version: '0.1.0' }, { instructions: SERVER_INSTRUCTIONS });
+    registerSearchDocsTool(server, engine);
+    registerGetDocTool(server, engine);
+    registerListCategoriesTool(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +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"}

package/dist/text.d.ts

@@ -0,0 +1,2 @@
+export declare function buildSummary(content: string, maxLength?: number): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,MAAM,CAMpF"}

package/dist/text.js

@@ -0,0 +1,8 @@
+import { SUMMARY_MAX_LENGTH } from './constants.js';
+export function buildSummary(content, maxLength = SUMMARY_MAX_LENGTH) {
+    if (content.length <= maxLength) {
+        return content;
+    }
+    return `${content.slice(0, maxLength)}...`;
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAAS,GAAG,kBAAkB;IAC1E,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;AAC7C,CAAC"}

package/dist/tools/get-doc.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SearchEngine } from '../search/engine.js';
+export declare function registerGetDocTool(server: McpServer, engine: SearchEngine): void;
+//# sourceMappingURL=get-doc.d.ts.map

package/dist/tools/get-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-doc.d.ts","sourceRoot":"","sources":["../../src/tools/get-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmChF"}

package/dist/tools/get-doc.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export function registerGetDocTool(server, engine) {
+    server.tool('get_doc', 'search_docs で得た id を指定して、ドキュメントの全文を取得する。', {
+        id: z.string().describe('canonical_id（例: "yaya:マニュアル/関数/REPLACE", "satori:特殊記号一覧", "ukadoc:list_sakura_script:tag_s"）'),
+    }, async ({ id }) => {
+        const entry = engine.getById(id);
+        if (!entry) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'not_found',
+                            message: `id "${id}" のドキュメントが見つかりませんでした。search_docs で正しい id を確認してください。`,
+                        }),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'ok',
+                        data: entry,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-doc.js.map

package/dist/tools/get-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-doc.js","sourceRoot":"","sources":["../../src/tools/get-doc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAoB;IACxE,MAAM,CAAC,IAAI,CACT,SAAS,EACT,0CAA0C,EAC1C;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACrB,8FAA8F,CAC/F;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,WAAW;4BACnB,OAAO,EAAE,OAAO,EAAE,qDAAqD;yBACxE,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,IAAI,EAAE,KAAK;qBACZ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-categories.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerListCategoriesTool(server: McpServer): void;
+//# sourceMappingURL=list-categories.d.ts.map

package/dist/tools/list-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.d.ts","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBlE"}

package/dist/tools/list-categories.js

@@ -0,0 +1,21 @@
+import { CATEGORIES } from '../constants.js';
+const CATEGORY_KEYS = Object.keys(CATEGORIES);
+export function registerListCategoriesTool(server) {
+    server.tool('list_categories', '検索に使えるカテゴリ一覧を返す。search_docs の category パラメータに使用する。', {}, async () => {
+        const categories = CATEGORY_KEYS.map(id => ({
+            id,
+            source: CATEGORIES[id].source,
+            label: CATEGORIES[id].label,
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'ok',
+                        data: categories,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=list-categories.js.map

package/dist/tools/list-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.js","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAe,CAAC;AAE5D,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oDAAoD,EACpD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1C,EAAE;YACF,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM;YAC7B,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK;SAC5B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM,EAAE,IAAI;wBACZ,IAAI,EAAE,UAAU;qBACjB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}