@ceed/docs-mcp 1.0.0-next.1

package/dist/rag/storage.d.ts

@@ -0,0 +1,3 @@
+import type { EmbeddingIndex } from './types.js';
+export declare const loadEmbeddingIndex: (indexPath?: string) => Promise<EmbeddingIndex>;
+export declare const saveEmbeddingIndex: (index: EmbeddingIndex, indexPath?: string) => Promise<void>;

package/dist/rag/storage.js

@@ -0,0 +1,15 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { INDEX_PATH } from './constants.js';
+export const loadEmbeddingIndex = async (indexPath = INDEX_PATH) => {
+    const raw = await readFile(indexPath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed.chunks)) {
+        throw new Error('Invalid embedding index: missing chunks array');
+    }
+    return parsed;
+};
+export const saveEmbeddingIndex = async (index, indexPath = INDEX_PATH) => {
+    const payload = JSON.stringify(index, null, 2);
+    await writeFile(indexPath, payload, 'utf-8');
+};
+//# sourceMappingURL=storage.js.map

package/dist/rag/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/rag/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,YAAoB,UAAU,EAA2B,EAAE;IAChG,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAEjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAAqB,EAAE,YAAoB,UAAU,EAAE,EAAE;IAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC","sourcesContent":["import { readFile, writeFile } from 'node:fs/promises';\n\nimport { INDEX_PATH } from './constants.js';\nimport type { EmbeddingIndex } from './types.js';\n\nexport const loadEmbeddingIndex = async (indexPath: string = INDEX_PATH): Promise<EmbeddingIndex> => {\n    const raw = await readFile(indexPath, 'utf-8');\n    const parsed = JSON.parse(raw) as EmbeddingIndex;\n\n    if (!Array.isArray(parsed.chunks)) {\n        throw new Error('Invalid embedding index: missing chunks array');\n    }\n\n    return parsed;\n};\n\nexport const saveEmbeddingIndex = async (index: EmbeddingIndex, indexPath: string = INDEX_PATH) => {\n    const payload = JSON.stringify(index, null, 2);\n    await writeFile(indexPath, payload, 'utf-8');\n};\n"]}

package/dist/rag/types.d.ts

@@ -0,0 +1,28 @@
+export interface DocumentMetadata {
+    source: string;
+    heading?: string;
+}
+export interface DocumentChunk {
+    id: string;
+    text: string;
+    metadata: DocumentMetadata;
+}
+export interface EmbeddingChunk extends DocumentChunk {
+    embedding: number[];
+}
+export interface EmbeddingIndex {
+    model: string;
+    dimension: number;
+    createdAt: string;
+    chunks: EmbeddingChunk[];
+}
+export interface SearchResult extends DocumentChunk {
+    score: number;
+}
+export interface SearchResultsPage {
+    results: SearchResult[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+}

package/dist/rag/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface DocumentMetadata {\n    source: string;\n    heading?: string;\n}\n\nexport interface DocumentChunk {\n    id: string;\n    text: string;\n    metadata: DocumentMetadata;\n}\n\nexport interface EmbeddingChunk extends DocumentChunk {\n    embedding: number[];\n}\n\nexport interface EmbeddingIndex {\n    model: string;\n    dimension: number;\n    createdAt: string;\n    chunks: EmbeddingChunk[];\n}\n\nexport interface SearchResult extends DocumentChunk {\n    score: number;\n}\n\nexport interface SearchResultsPage {\n    results: SearchResult[];\n    total: number;\n    page: number;\n    pageSize: number;\n    hasMore: boolean;\n}\n"]}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const createDocsMcpServer: () => McpServer;
+export declare const startDocsMcpServer: () => Promise<void>;

package/dist/server.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import { pathToFileURL } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { createRagSearcher } from './rag/search.js';
+import { DOCS_MCP_VERSION } from './version.js';
+const pingSchema = z.object({
+    message: z.string().optional(),
+});
+const pingInputSchema = pingSchema.shape;
+const searchSchema = z.object({
+    packageName: z.enum(['@ceed/ads', '@ceed/cds']).describe('Package to search (@ceed/ads or @ceed/cds).'),
+    query: z.string().min(1, 'Query text is required.'),
+    topK: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Number of matches to return per page (default: 5, max: 100).'),
+    page: z.number().int().min(1).optional().describe('Results page to fetch (default: 1).'),
+});
+const searchInputSchema = searchSchema.shape;
+const formatSearchResult = (rank, result) => {
+    const lines = [`#${rank + 1} (score: ${result.score.toFixed(3)})`, `source: ${result.metadata.source}`];
+    if (result.metadata.heading) {
+        lines.splice(1, 0, `heading: ${result.metadata.heading}`);
+    }
+    lines.push('', result.text.trim());
+    return lines.join('\n');
+};
+export const createDocsMcpServer = () => {
+    const server = new McpServer({
+        name: '@ceed/docs-mcp',
+        version: DOCS_MCP_VERSION,
+    });
+    const ragSearcher = createRagSearcher();
+    server.registerTool('ping', {
+        title: 'Ping',
+        description: 'Return a simple response to verify the MCP server is healthy.',
+        inputSchema: pingInputSchema,
+    }, async (rawInput) => {
+        const { message } = pingSchema.parse(rawInput);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: message ?? 'pong',
+                },
+            ],
+        };
+    });
+    server.registerTool('search', {
+        title: 'Search documentation',
+        description: 'Look up documentation chunks that best match the given query.',
+        inputSchema: searchInputSchema,
+    }, async (rawInput) => {
+        const { packageName, query, topK, page } = searchSchema.parse(rawInput);
+        const packageKey = packageName.split('/').pop() ?? undefined;
+        try {
+            const pageData = await ragSearcher.search(query, topK, packageKey, page);
+            const { results, total, page: currentPage, pageSize, hasMore } = pageData;
+            if (results.length === 0) {
+                if (total === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No matching documentation found.',
+                            },
+                        ],
+                    };
+                }
+                const totalPages = Math.max(1, Math.ceil(total / pageSize));
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No results on page ${currentPage}. Try a page value between 1 and ${totalPages}.`,
+                        },
+                    ],
+                };
+            }
+            const totalPages = Math.max(1, Math.ceil(total / pageSize));
+            const startIndex = (currentPage - 1) * pageSize;
+            const headerLines = [
+                `Total matches: ${total}`,
+                `Page ${currentPage} of ${totalPages} (page size ${pageSize})`,
+            ];
+            if (hasMore) {
+                headerLines.push('More results available. Increase the page value to continue.');
+            }
+            const formatted = results
+                .map((result, index) => formatSearchResult(startIndex + index, result))
+                .join('\n\n---\n\n');
+            const text = `${headerLines.join('\n')}\n\n${formatted}`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown search error';
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to search documentation index: ${message}`,
+                    },
+                ],
+            };
+        }
+    });
+    return server;
+};
+export const startDocsMcpServer = async () => {
+    const server = createDocsMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+};
+const invokedFromCli = () => {
+    const entry = process.argv[1];
+    if (!entry) {
+        return false;
+    }
+    return import.meta.url === pathToFileURL(entry).href;
+};
+if (invokedFromCli()) {
+    startDocsMcpServer().catch((error) => {
+        console.error('Failed to start @ceed/docs-mcp server:', error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { pathToFileURL } from 'node:url';\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\n\nimport { createRagSearcher } from './rag/search.js';\nimport type { SearchResult } from './rag/types.js';\nimport { DOCS_MCP_VERSION } from './version.js';\n\nconst pingSchema = z.object({\n    message: z.string().optional(),\n});\n\nconst pingInputSchema = pingSchema.shape;\n\nconst searchSchema = z.object({\n    packageName: z.enum(['@ceed/ads', '@ceed/cds']).describe('Package to search (@ceed/ads or @ceed/cds).'),\n    query: z.string().min(1, 'Query text is required.'),\n    topK: z\n        .number()\n        .int()\n        .min(1)\n        .max(100)\n        .optional()\n        .describe('Number of matches to return per page (default: 5, max: 100).'),\n    page: z.number().int().min(1).optional().describe('Results page to fetch (default: 1).'),\n});\n\nconst searchInputSchema = searchSchema.shape;\n\nconst formatSearchResult = (rank: number, result: SearchResult) => {\n    const lines = [`#${rank + 1} (score: ${result.score.toFixed(3)})`, `source: ${result.metadata.source}`];\n\n    if (result.metadata.heading) {\n        lines.splice(1, 0, `heading: ${result.metadata.heading}`);\n    }\n\n    lines.push('', result.text.trim());\n\n    return lines.join('\\n');\n};\n\nexport const createDocsMcpServer = () => {\n    const server = new McpServer({\n        name: '@ceed/docs-mcp',\n        version: DOCS_MCP_VERSION,\n    });\n\n    const ragSearcher = createRagSearcher();\n\n    server.registerTool(\n        'ping',\n        {\n            title: 'Ping',\n            description: 'Return a simple response to verify the MCP server is healthy.',\n            inputSchema: pingInputSchema,\n        },\n        async (rawInput) => {\n            const { message } = pingSchema.parse(rawInput);\n\n            return {\n                content: [\n                    {\n                        type: 'text',\n                        text: message ?? 'pong',\n                    },\n                ],\n            };\n        },\n    );\n\n    server.registerTool(\n        'search',\n        {\n            title: 'Search documentation',\n            description: 'Look up documentation chunks that best match the given query.',\n            inputSchema: searchInputSchema,\n        },\n        async (rawInput) => {\n            const { packageName, query, topK, page } = searchSchema.parse(rawInput);\n            const packageKey = packageName.split('/').pop() ?? undefined;\n\n            try {\n                const pageData = await ragSearcher.search(query, topK, packageKey, page);\n                const { results, total, page: currentPage, pageSize, hasMore } = pageData;\n\n                if (results.length === 0) {\n                    if (total === 0) {\n                        return {\n                            content: [\n                                {\n                                    type: 'text',\n                                    text: 'No matching documentation found.',\n                                },\n                            ],\n                        };\n                    }\n\n                    const totalPages = Math.max(1, Math.ceil(total / pageSize));\n\n                    return {\n                        content: [\n                            {\n                                type: 'text',\n                                text: `No results on page ${currentPage}. Try a page value between 1 and ${totalPages}.`,\n                            },\n                        ],\n                    };\n                }\n\n                const totalPages = Math.max(1, Math.ceil(total / pageSize));\n                const startIndex = (currentPage - 1) * pageSize;\n                const headerLines = [\n                    `Total matches: ${total}`,\n                    `Page ${currentPage} of ${totalPages} (page size ${pageSize})`,\n                ];\n\n                if (hasMore) {\n                    headerLines.push('More results available. Increase the page value to continue.');\n                }\n\n                const formatted = results\n                    .map((result, index) => formatSearchResult(startIndex + index, result))\n                    .join('\\n\\n---\\n\\n');\n\n                const text = `${headerLines.join('\\n')}\\n\\n${formatted}`;\n\n                return {\n                    content: [\n                        {\n                            type: 'text',\n                            text,\n                        },\n                    ],\n                };\n            } catch (error) {\n                const message = error instanceof Error ? error.message : 'Unknown search error';\n\n                return {\n                    isError: true,\n                    content: [\n                        {\n                            type: 'text',\n                            text: `Failed to search documentation index: ${message}`,\n                        },\n                    ],\n                };\n            }\n        },\n    );\n\n    return server;\n};\n\nexport const startDocsMcpServer = async () => {\n    const server = createDocsMcpServer();\n    const transport = new StdioServerTransport();\n\n    await server.connect(transport);\n};\n\nconst invokedFromCli = () => {\n    const entry = process.argv[1];\n\n    if (!entry) {\n        return false;\n    }\n\n    return import.meta.url === pathToFileURL(entry).href;\n};\n\nif (invokedFromCli()) {\n    startDocsMcpServer().catch((error) => {\n        console.error('Failed to start @ceed/docs-mcp server:', error);\n        process.exitCode = 1;\n    });\n}\n"]}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const DOCS_MCP_VERSION: string;

package/dist/version.js

@@ -0,0 +1,9 @@
+import { readFileSync } from 'node:fs';
+const packageJsonUrl = new URL('../package.json', import.meta.url);
+const packageJson = JSON.parse(readFileSync(packageJsonUrl, 'utf8'));
+const version = typeof packageJson.version === 'string' ? packageJson.version : undefined;
+if (!version) {
+    throw new Error('Package version is missing from package.json');
+}
+export const DOCS_MCP_VERSION = version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAElE,CAAC;AAEF,MAAM,OAAO,GAAG,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAE1F,IAAI,CAAC,OAAO,EAAE,CAAC;IACX,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC","sourcesContent":["import { readFileSync } from 'node:fs';\n\nconst packageJsonUrl = new URL('../package.json', import.meta.url);\nconst packageJson = JSON.parse(readFileSync(packageJsonUrl, 'utf8')) as {\n    version?: unknown;\n};\n\nconst version = typeof packageJson.version === 'string' ? packageJson.version : undefined;\n\nif (!version) {\n    throw new Error('Package version is missing from package.json');\n}\n\nexport const DOCS_MCP_VERSION = version;\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ceed/docs-mcp",
+  "version": "1.0.0-next.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "description": "Documentation tooling for the MCP project",
+  "scripts": {
+    "extract:docs": "rm -rf ./rag-source && node ../../scripts/generate-llms-txt.mjs --input ../ads/stories --output ./rag-source/ads --project-name \"@ceed/ads Component Guide\" && node ../../scripts/generate-llms-txt.mjs --input ../cds/stories --output ./rag-source/cds --project-name \"@ceed/cds Component Guide\"",
+    "build:index": "node dist/rag/build-index.js",
+    "build": "rm -rf ./dist && tsc -p tsconfig.build.json",
+    "dev": "yarn build && mcp-inspector node dist/server.js",
+    "lint": "oxlint && eslint \"./src/**/*.{ts,tsx}\"",
+    "lint:fix": "oxlint --fix && eslint --fix \"./src/**/*.{ts,tsx}\""
+  },
+  "files": [
+    "dist",
+    "rag-index.json"
+  ],
+  "bin": "dist/server.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "author": "Ecube Labs",
+  "license": "MIT",
+  "sideEffects": false,
+  "devDependencies": {
+    "@ecubelabs/tsconfig": "^1.0.0",
+    "@modelcontextprotocol/inspector": "^0.16.7",
+    "@types/node": "^22.0.0",
+    "eslint": "^8.46.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-oxlint": "^1.9.0",
+    "eslint-plugin-prettier": "^5.5.1",
+    "oxlint": "^1.9.0",
+    "prettier": "^3.6.2",
+    "semantic-release": "^24.2.1",
+    "semantic-release-yarn": "^3.0.2",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@xenova/transformers": "^2.17.2",
+    "zod": "^3.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/Ecube-Labs/hds.git"
+  },
+  "packageManager": "yarn@4.1.0",
+  "stableVersion": "0.1.0"
+}