ngx-oneforall-mcp 1.0.0

package/dist/data.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Data layer for the MCP server.
+ *
+ * Reads the bundled docs.json (generated at build time by scripts/bundle-docs.mjs)
+ * to provide an indexed, searchable collection of all ngx-oneforall utilities.
+ */
+export interface Utility {
+    name: string;
+    category: string;
+    categoryTitle: string;
+    dirName: string;
+    routePath: string;
+    importPath: string;
+    url: string;
+    description: string;
+    fullContent: string;
+}
+export interface UtilityIndex {
+    utilities: Utility[];
+    byCategory: Map<string, Utility[]>;
+    byName: Map<string, Utility>;
+    categories: string[];
+    llmsTxt: string;
+}
+/**
+ * Load and index all utility documentation from the bundled docs.json.
+ */
+export declare function loadUtilities(): UtilityIndex;

package/dist/data.js

@@ -0,0 +1,74 @@
+/**
+ * Data layer for the MCP server.
+ *
+ * Reads the bundled docs.json (generated at build time by scripts/bundle-docs.mjs)
+ * to provide an indexed, searchable collection of all ngx-oneforall utilities.
+ */
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CATEGORY_ORDER = [
+    ['getting-started', 'Getting Started'],
+    ['constants', 'Constants'],
+    ['decorators', 'Decorators'],
+    ['directives', 'Directives'],
+    ['guards', 'Guards'],
+    ['interceptors', 'Interceptors'],
+    ['pipes', 'Pipes'],
+    ['rxjs', 'RxJS'],
+    ['services', 'Services'],
+    ['signals', 'Signals'],
+    ['types', 'Types'],
+    ['utils', 'Utils'],
+    ['validators', 'Validators'],
+];
+/**
+ * Load and index all utility documentation from the bundled docs.json.
+ */
+export function loadUtilities() {
+    // Read from bundled data (relative to dist/ → ../data/docs.json)
+    const docsPath = join(__dirname, '..', 'data', 'docs.json');
+    const raw = readFileSync(docsPath, 'utf-8');
+    const { utilities } = JSON.parse(raw);
+    const byCategory = new Map();
+    const byName = new Map();
+    const categories = [];
+    for (const utility of utilities) {
+        // Group by category
+        if (!byCategory.has(utility.category)) {
+            byCategory.set(utility.category, []);
+            categories.push(utility.category);
+        }
+        byCategory.get(utility.category).push(utility);
+        // Index by name variants for lookup
+        byName.set(utility.name.toLowerCase(), utility);
+        byName.set(utility.dirName, utility);
+    }
+    // Build llms.txt content
+    const llmsLines = [
+        '# ngx-oneforall',
+        '',
+        '> A collection of 85+ high-quality Angular utilities.',
+        '> Tree-shakable, zero-dependency, SSR-ready, 100% test coverage.',
+        '',
+    ];
+    for (const [cat, pages] of byCategory) {
+        const catTitle = CATEGORY_ORDER.find(([d]) => d === cat)?.[1] || cat;
+        llmsLines.push(`## ${catTitle}`);
+        llmsLines.push('');
+        for (const p of pages) {
+            const desc = p.description ? `: ${p.description}` : '';
+            llmsLines.push(`- [${p.name}](${p.url})${desc}`);
+        }
+        llmsLines.push('');
+    }
+    return {
+        utilities,
+        byCategory,
+        byName,
+        categories,
+        llmsTxt: llmsLines.join('\n'),
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ngx-oneforall MCP Server
+ *
+ * Provides AI tools with native knowledge of all ngx-oneforall
+ * Angular utilities via the Model Context Protocol.
+ *
+ * Usage:
+ *   npx @ngx-oneforall/mcp-server
+ *
+ * Or add to your MCP config:
+ *   {
+ *     "mcpServers": {
+ *       "ngx-oneforall": {
+ *         "command": "npx",
+ *         "args": ["-y", "@ngx-oneforall/mcp-server"]
+ *       }
+ *     }
+ *   }
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,99 @@
+/**
+ * ngx-oneforall MCP Server
+ *
+ * Provides AI tools with native knowledge of all ngx-oneforall
+ * Angular utilities via the Model Context Protocol.
+ *
+ * Usage:
+ *   npx @ngx-oneforall/mcp-server
+ *
+ * Or add to your MCP config:
+ *   {
+ *     "mcpServers": {
+ *       "ngx-oneforall": {
+ *         "command": "npx",
+ *         "args": ["-y", "@ngx-oneforall/mcp-server"]
+ *       }
+ *     }
+ *   }
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { loadUtilities } from './data.js';
+import { registerTools } from './tools.js';
+// Load documentation index
+const index = loadUtilities();
+// Create MCP server
+const server = new McpServer({
+    name: 'ngx-oneforall',
+    version: '1.2.1',
+});
+// --- Register Tools ---
+registerTools(server, index);
+// --- Register Resources ---
+// Static resource: llms.txt
+server.registerResource('llms-txt', 'ngx-oneforall://llms.txt', {
+    title: 'ngx-oneforall LLMs.txt',
+    description: 'Structured index of all ngx-oneforall utilities with links and descriptions',
+    mimeType: 'text/plain',
+}, async (uri) => ({
+    contents: [
+        {
+            uri: uri.href,
+            text: index.llmsTxt,
+        },
+    ],
+}));
+// Dynamic resource: per-utility docs
+server.registerResource('utility-docs', new ResourceTemplate('ngx-oneforall://docs/{category}/{utility}', {
+    list: async () => ({
+        resources: index.utilities.map(u => ({
+            uri: `ngx-oneforall://docs/${u.category}/${u.dirName}`,
+            name: `${u.name} (${u.categoryTitle})`,
+            description: u.description,
+            mimeType: 'text/markdown',
+        })),
+    }),
+}), {
+    title: 'Utility Documentation',
+    description: 'Full documentation for a specific ngx-oneforall utility',
+    mimeType: 'text/markdown',
+}, async (uri, { category, utility }) => {
+    const cat = category;
+    const util = utility;
+    const utilities = index.byCategory.get(cat);
+    const found = utilities?.find(u => u.dirName === util);
+    if (!found) {
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    text: `Utility not found: ${cat}/${util}`,
+                },
+            ],
+        };
+    }
+    const header = [
+        `# ${found.name}`,
+        '',
+        `**Category**: ${found.categoryTitle}`,
+        `**Import**: \`${found.importPath}\``,
+        `**Docs**: ${found.url}`,
+        '',
+        '---',
+        '',
+    ].join('\n');
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                text: header + found.fullContent,
+            },
+        ],
+    };
+});
+// --- Start Server ---
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP tool registrations for ngx-oneforall.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type UtilityIndex } from './data.js';
+/**
+ * Register all MCP tools on the server.
+ */
+export declare function registerTools(server: McpServer, index: UtilityIndex): void;

package/dist/tools.js

@@ -0,0 +1,247 @@
+/**
+ * MCP tool registrations for ngx-oneforall.
+ */
+import { z } from 'zod';
+/**
+ * Simple text search across utility names, descriptions, and content.
+ */
+function searchIndex(index, query) {
+    const q = query.toLowerCase();
+    const scored = [];
+    for (const utility of index.utilities) {
+        let score = 0;
+        // Exact name match is highest priority
+        if (utility.name.toLowerCase() === q) {
+            score += 100;
+        }
+        else if (utility.name.toLowerCase().includes(q)) {
+            score += 50;
+        }
+        // dir name match
+        if (utility.dirName.includes(q)) {
+            score += 40;
+        }
+        // Category match
+        if (utility.category.includes(q) ||
+            utility.categoryTitle.toLowerCase().includes(q)) {
+            score += 20;
+        }
+        // Description match
+        if (utility.description.toLowerCase().includes(q)) {
+            score += 30;
+        }
+        // Full content match
+        if (utility.fullContent.toLowerCase().includes(q)) {
+            score += 10;
+        }
+        if (score > 0) {
+            scored.push({ utility, score });
+        }
+    }
+    return scored.sort((a, b) => b.score - a.score).map(s => s.utility);
+}
+/**
+ * Find a utility by name (case-insensitive, supports partial matching).
+ */
+function findUtility(index, name) {
+    const q = name.toLowerCase().trim();
+    // Exact match first
+    const exact = index.byName.get(q);
+    if (exact)
+        return exact;
+    // Try partial match
+    for (const utility of index.utilities) {
+        if (utility.name.toLowerCase() === q ||
+            utility.dirName === q ||
+            utility.dirName === q.replace(/\s+/g, '-')) {
+            return utility;
+        }
+    }
+    // Fuzzy: find closest match
+    const results = searchIndex(index, q);
+    return results.length > 0 ? results[0] : undefined;
+}
+/**
+ * Format a utility listing for display.
+ */
+function formatUtilityListing(utility) {
+    return `- **${utility.name}** (\`${utility.importPath}\`): ${utility.description || 'No description available.'}`;
+}
+/**
+ * Register all MCP tools on the server.
+ */
+export function registerTools(server, index) {
+    // --- get_utility_docs ---
+    server.registerTool('get_utility_docs', {
+        title: 'Get Utility Documentation',
+        description: 'Get the full documentation for a specific ngx-oneforall utility by name. Returns complete markdown docs including API reference, usage examples, and code snippets.',
+        inputSchema: z.object({
+            name: z
+                .string()
+                .describe('Name of the utility (e.g., "draggable", "cache", "time-ago", "debounced-signal")'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async ({ name }) => {
+        const utility = findUtility(index, name);
+        if (!utility) {
+            const suggestions = searchIndex(index, name).slice(0, 5);
+            const suggestionText = suggestions.length > 0
+                ? `\n\nDid you mean one of these?\n${suggestions.map(u => `- ${u.name} (${u.category})`).join('\n')}`
+                : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Utility "${name}" not found.${suggestionText}`,
+                    },
+                ],
+            };
+        }
+        const header = [
+            `# ${utility.name}`,
+            '',
+            `**Category**: ${utility.categoryTitle}`,
+            `**Import**: \`import { ... } from '${utility.importPath}';\``,
+            `**Docs**: ${utility.url}`,
+            '',
+            '---',
+            '',
+        ].join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: header + (utility.fullContent || 'No documentation available.'),
+                },
+            ],
+        };
+    });
+    // --- search_utilities ---
+    server.registerTool('search_utilities', {
+        title: 'Search Utilities',
+        description: 'Search ngx-oneforall utilities by keyword. Searches across names, descriptions, and documentation content. Returns matching utilities with their import paths and descriptions.',
+        inputSchema: z.object({
+            query: z
+                .string()
+                .describe('Search term (e.g., "keyboard", "cache", "form validation", "signal")'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async ({ query }) => {
+        const results = searchIndex(index, query);
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No utilities found matching "${query}".`,
+                    },
+                ],
+            };
+        }
+        const lines = [
+            `# Search Results for "${query}"`,
+            '',
+            `Found ${results.length} matching utilities:`,
+            '',
+            ...results.map(u => formatUtilityListing(u)),
+        ];
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+    // --- list_utilities ---
+    server.registerTool('list_utilities', {
+        title: 'List Utilities',
+        description: 'List all ngx-oneforall utilities, optionally filtered by category. Returns utility names, import paths, and descriptions grouped by category.',
+        inputSchema: z.object({
+            category: z
+                .string()
+                .optional()
+                .describe('Optional category filter (e.g., "directives", "pipes", "signals", "validators")'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async ({ category }) => {
+        const lines = [];
+        if (category) {
+            const cat = category.toLowerCase();
+            const utilities = index.byCategory.get(cat);
+            if (!utilities) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Category "${category}" not found. Available categories: ${index.categories.join(', ')}`,
+                        },
+                    ],
+                };
+            }
+            const catTitle = utilities[0]?.categoryTitle || category;
+            lines.push(`# ${catTitle}`);
+            lines.push('');
+            lines.push(`${utilities.length} utilities:`);
+            lines.push('');
+            for (const u of utilities) {
+                lines.push(formatUtilityListing(u));
+            }
+        }
+        else {
+            lines.push('# All ngx-oneforall Utilities');
+            lines.push('');
+            lines.push(`${index.utilities.length} utilities across ${index.categories.length} categories:`);
+            lines.push('');
+            for (const [cat, utilities] of index.byCategory) {
+                const catTitle = utilities[0]?.categoryTitle || cat;
+                lines.push(`## ${catTitle} (${utilities.length})`);
+                lines.push('');
+                for (const u of utilities) {
+                    lines.push(formatUtilityListing(u));
+                }
+                lines.push('');
+            }
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+    // --- get_import_path ---
+    server.registerTool('get_import_path', {
+        title: 'Get Import Path',
+        description: 'Get the exact TypeScript import statement for a specific ngx-oneforall utility. Returns the correct import path for use in Angular projects.',
+        inputSchema: z.object({
+            name: z
+                .string()
+                .describe('Name of the utility (e.g., "draggable", "time-ago", "cache")'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async ({ name }) => {
+        const utility = findUtility(index, name);
+        if (!utility) {
+            const suggestions = searchIndex(index, name).slice(0, 3);
+            const suggestionText = suggestions.length > 0
+                ? `\n\nDid you mean: ${suggestions.map(u => u.name).join(', ')}?`
+                : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Utility "${name}" not found.${suggestionText}`,
+                    },
+                ],
+            };
+        }
+        const text = [
+            `**${utility.name}**`,
+            '',
+            '```typescript',
+            `import { ... } from '${utility.importPath}';`,
+            '```',
+            '',
+            `**Category**: ${utility.categoryTitle}`,
+            `**Docs**: ${utility.url}`,
+        ].join('\n');
+        return {
+            content: [{ type: 'text', text }],
+        };
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "ngx-oneforall-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for ngx-oneforall Angular utility library — gives AI tools native knowledge of all utilities",
+  "type": "module",
+  "bin": {
+    "ngx-oneforall-mcp": "./bin/cli.mjs"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "bin",
+    "data"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/bundle-docs.mjs",
+    "build": "tsc",
+    "start": "node bin/cli.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "angular",
+    "ngx-oneforall",
+    "ai",
+    "llm"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/love1024/ngx-oneforall",
+    "directory": "projects/ngx-oneforall-mcp"
+  },
+  "homepage": "https://love1024.github.io/ngx-oneforall",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3"
+  }
+}