ukagaka-doc-mcp 0.1.0

package/dist/tools/search-docs.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 registerSearchDocsTool(server: McpServer, engine: SearchEngine): void;
+//# sourceMappingURL=search-docs.d.ts.map

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

@@ -0,0 +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;AAOxD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8CpF"}

package/dist/tools/search-docs.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { CATEGORIES } from '../constants.js';
+const SOURCE_VALUES = ['ukadoc', 'yaya_wiki', 'satori_wiki'];
+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('検索キーワード'),
+        category: z.enum(CATEGORY_KEYS).optional()
+            .describe('カテゴリで絞り込み（list_categories で確認可能）'),
+        source: z.enum(SOURCE_VALUES).optional()
+            .describe('ソースで絞り込み: ukadoc / yaya_wiki / satori_wiki'),
+        limit: z.number().int().min(1).max(50).default(10)
+            .describe('返却件数の上限（デフォルト10、最大50）'),
+    }, async ({ query, category, source, limit }) => {
+        const { results, total } = engine.search(query, {
+            category: category,
+            source: source,
+            limit,
+        });
+        if (results.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'not_found',
+                            message: `「${query}」に一致するドキュメントが見つかりませんでした。`,
+                            total: 0,
+                        }),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'ok',
+                        total,
+                        showing: results.length,
+                        data: results,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=search-docs.js.map

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

@@ -0,0 +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,MAAM,iBAAiB,CAAC;AAG7C,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AACtE,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,6DAA6D,EAC7D;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,4CAA4C,CAAC;QACzD,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/dist/types.d.ts

@@ -0,0 +1,59 @@
+import type { CATEGORIES } from './constants.js';
+export type Source = 'ukadoc' | 'yaya_wiki' | 'satori_wiki';
+export type Category = keyof typeof CATEGORIES;
+/**
+ * ドキュメントエントリ（全文を含む）。
+ * index.json に保存される形式。
+ */
+export interface DocEntry {
+    /** canonical_id
+     * - ukadoc: `ukadoc:{filename}:{section_anchor}`
+     * - yaya_wiki: `yaya:{page_path}` (URLデコード済み日本語パス)
+     * - satori_wiki: `satori:{page_name}` (URLデコード済み)
+     */
+    id: string;
+    title: string;
+    source: Source;
+    category: Category;
+    /** 本文全文（truncationなし） */
+    content: string;
+    /** 元ページURL */
+    url: string;
+}
+/**
+ * 検索結果エントリ（search_docs が返す形式）。
+ * content の先頭500文字を summary として返すことでトークン消費を抑える。
+ */
+export interface SearchEntry {
+    id: string;
+    title: string;
+    source: Source;
+    category: Category;
+    /** content 先頭500文字 */
+    summary: string;
+    url: string;
+}
+export interface IndexFile {
+    /** スキーマバージョン。互換性チェック用 */
+    version: number;
+    /** ビルド日時 (ISO 8601) */
+    generatedAt: string;
+    entries: DocEntry[];
+}
+export interface SearchResult {
+    status: 'ok' | 'not_found' | 'error';
+    data?: SearchEntry[];
+    total?: number;
+    message?: string;
+}
+export interface GetDocResult {
+    status: 'ok' | 'not_found' | 'error';
+    data?: DocEntry;
+    message?: string;
+}
+export interface CategoryInfo {
+    id: Category;
+    source: Source;
+    label: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAG5D,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// 共通型定義
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,QAAQ;AACR,+DAA+D"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ukagaka-doc-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for searching Ukagaka (伺か) technical documentation: UKADOC, YAYA Wiki, and 里々Wiki",
+  "keywords": [
+    "mcp",
+    "ukagaka",
+    "ssp",
+    "yaya",
+    "satori",
+    "documentation",
+    "search"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/finelagusaz/ukagaka-doc-mcp.git"
+  },
+  "homepage": "https://github.com/finelagusaz/ukagaka-doc-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/finelagusaz/ukagaka-doc-mcp/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "bin": {
+    "ukagaka-doc-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data/index.json",
+    "LICENSE",
+    "NOTICE.md",
+    "README.md",
+    "SPEC.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:index": "tsx src/build-index.ts",
+    "dev": "tsx src/index.ts",
+    "refresh:index": "git submodule sync --recursive && git submodule update --init --remote docs/ukadoc && npm run build:index",
+    "start": "node dist/index.js",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "cheerio": "^1.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}