@spartan-ng/mcp 0.0.1-alpha.707

package/README.md

@@ -0,0 +1,149 @@
+# @spartan-ng/mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that exposes the [Spartan](https://www.spartan.ng) Angular UI ecosystem - documentation, components, and blocks - as tools, resources, and prompts for MCP clients such as Claude Desktop, Cursor, and other AI assistants.
+
+The server fetches content live from the public Spartan UI site and caches it on disk per version, so assistants can answer questions about Spartan components with up-to-date API tables and code examples.
+
+## What it provides
+
+- **Components** - list components and fetch a component's documentation, with structured Brain API (`Brn*`) / Helm API (`Hlm*`) extraction or raw code blocks.
+- **Blocks** - list and fetch pre-built UI patterns (sidebar, login, signup, calendar) and analyze the components/packages they depend on.
+- **Docs** - fetch official documentation topics (installation, cli, theming, dark-mode, typography, health-checks, update-guide) with optional code/heading/link extraction.
+- **Analysis** - inspect a component's dependencies (npm packages, Angular CDK, peer components, imports) and its accessibility features (ARIA, keyboard, screen reader, WCAG).
+- **Health** - check availability of the Spartan docs site and surface the Spartan CLI health-check commands.
+- **Caching** - version-aware on-disk cache with status, clear, rebuild, switch-version, and list-versions tools.
+
+## Usage
+
+### With `npx` (no install)
+
+Configure your MCP client:
+
+```json
+{
+	"mcpServers": {
+		"spartan-ui": {
+			"command": "npx",
+			"args": ["-y", "@spartan-ng/mcp"]
+		}
+	}
+}
+```
+
+### Global install
+
+```bash
+npm install -g @spartan-ng/mcp
+```
+
+```json
+{
+	"mcpServers": {
+		"spartan-ui": {
+			"command": "spartan-mcp"
+		}
+	}
+}
+```
+
+### Local build
+
+```json
+{
+	"mcpServers": {
+		"spartan-ui": {
+			"command": "node",
+			"args": ["/path/to/dist/libs/mcp/src/server.js"]
+		}
+	}
+}
+```
+
+1. Run `nx build mcp` to compile to `dist/libs/mcp`.
+2. Point `args` at the built `src/server.js`.
+3. Restart your MCP client.
+
+## MCP surface
+
+### Tools (17)
+
+| Tool                              | Description                                                              |
+| --------------------------------- | ------------------------------------------------------------------------ |
+| `spartan_components_list`         | List known components with documentation URLs                            |
+| `spartan_components_get`          | Fetch a component page; `extract: 'code' \| 'api'`                       |
+| `spartan_components_dependencies` | Analyze a component's dependencies                                       |
+| `spartan_accessibility_check`     | Analyze a component's accessibility features                             |
+| `spartan_blocks_list`             | List known blocks                                                        |
+| `spartan_blocks_get`              | Fetch a block page; `format: 'html' \| 'text'`                           |
+| `spartan_blocks_dependencies`     | Analyze a block's dependencies                                           |
+| `spartan_docs_get`                | Fetch a docs topic; `extract: 'none' \| 'code' \| 'headings' \| 'links'` |
+| `spartan_meta`                    | Topics, components, and blocks for client autocomplete                   |
+| `spartan_health_check`            | Check availability of docs/component pages                               |
+| `spartan_health_instructions`     | Spartan CLI health-check instructions                                    |
+| `spartan_health_command`          | Build the exact health-check command (`ng`/`nx`)                         |
+| `spartan_cache_status`            | Current cache version and statistics                                     |
+| `spartan_cache_clear`             | Clear the current (or all) cache version(s)                              |
+| `spartan_cache_rebuild`           | Rebuild the cache from the live site                                     |
+| `spartan_cache_switch_version`    | Switch the active cache version                                          |
+| `spartan_cache_list_versions`     | List cached versions                                                     |
+
+### Resources (4)
+
+- `spartan://components/list`
+- `spartan://component/{name}/api`
+- `spartan://component/{name}/examples`
+- `spartan://component/{name}/full`
+
+### Prompts (5)
+
+- `spartan-get-started`
+- `spartan-compare-apis`
+- `spartan-implement-feature`
+- `spartan-troubleshoot`
+- `spartan-list-components`
+
+## Example tool calls
+
+```json
+// List all known components
+{ "tool": "spartan_components_list" }
+
+// Fetch the accordion's structured API data
+{ "tool": "spartan_components_get", "name": "accordion", "extract": "api" }
+
+// Fetch a docs topic and extract its headings
+{ "tool": "spartan_docs_get", "topic": "cli", "extract": "headings" }
+
+// Fetch a block as plain text
+{ "tool": "spartan_blocks_get", "name": "sidebar", "format": "text" }
+
+// Analyze a component's dependencies
+{ "tool": "spartan_components_dependencies", "componentName": "dialog" }
+
+// Check docs-site availability
+{ "tool": "spartan_health_check", "topics": ["installation", "cli"] }
+```
+
+## Configuration
+
+Environment variables:
+
+| Variable                  | Default                                                 | Description                                                                 |
+| ------------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `SPARTAN_MCP_CACHE_DIR`   | `$XDG_CACHE_HOME/spartan-mcp` or `~/.cache/spartan-mcp` | Directory for the on-disk version cache. Override to use a custom location. |
+| `SPARTAN_CACHE_TTL_MS`    | `300000` (5 min)                                        | TTL for the in-memory fetch cache.                                          |
+| `SPARTAN_CACHE_TTL_HOURS` | `24`                                                    | TTL for on-disk cached entries before they are considered stale.            |
+
+## Notes
+
+- **Data source**: all content is fetched from public pages at [spartan.ng](https://www.spartan.ng); responses include source URLs.
+- **Input validation**: all tool inputs are validated with Zod schemas.
+- **Versions**: cached data is stored per Spartan UI version under `cache/{version}/`; pass `spartanVersion` to component/block/docs tools or use `spartan_cache_switch_version`.
+
+## Development
+
+This library was generated with [Nx](https://nx.dev).
+
+- Build: `nx build mcp`
+- Test: `nx test mcp`
+- Lint: `nx lint mcp`

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@spartan-ng/mcp",
+  "version": "0.0.1-alpha.707",
+  "description": "Model Context Protocol server exposing Spartan Angular UI documentation, components, and blocks as AI-consumable tools.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "spartan",
+    "angular",
+    "ui",
+    "spartan-ui",
+    "spartan-blocks",
+    "components",
+    "documentation"
+  ],
+  "homepage": "https://spartan.ng",
+  "bugs": {
+    "url": "https://github.com/spartan-ng/spartan/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spartan-ng/spartan.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "bin": {
+    "spartan-mcp": "./src/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "tslib": "~2.8.1",
+    "zod": "^3.25.76"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from './tools/utils.js';

package/src/index.js

@@ -0,0 +1,2 @@
+export * from './tools/utils.js';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/mcp/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/src/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/server.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAnalysisTools } from './tools/analysis.js';
+import { registerBlockTools } from './tools/blocks.js';
+import { registerCacheTools } from './tools/cache-tools.js';
+import { registerComponentTools } from './tools/components.js';
+import { registerDocsTools } from './tools/docs.js';
+import { registerHealthTools } from './tools/health.js';
+import { registerMetaTools } from './tools/meta.js';
+import { registerPromptHandlers } from './tools/prompts.js';
+import { registerResourceHandlers } from './tools/resources.js';
+const server = new McpServer({
+    name: 'spartan-ui',
+    version: '0.0.1',
+    description: 'MCP server exposing Spartan Angular UI documentation, component tools, and blocks.',
+});
+// Register tool modules
+registerComponentTools(server);
+registerDocsTools(server);
+registerHealthTools(server);
+registerMetaTools(server);
+registerAnalysisTools(server);
+registerCacheTools(server);
+registerBlockTools(server);
+// Register resource handlers
+registerResourceHandlers(server);
+// Register prompt handlers
+registerPromptHandlers(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../libs/mcp/src/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC5B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,oFAAoF;CACjG,CAAC,CAAC;AAEH,wBAAwB;AACxB,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,6BAA6B;AAC7B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAEjC,2BAA2B;AAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/src/tools/analysis.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAnalysisTools(server: McpServer): void;

package/src/tools/analysis.js

@@ -0,0 +1,269 @@
+import { z } from 'zod';
+import { KNOWN_COMPONENTS, SPARTAN_COMPONENTS_BASE, fetchContent, htmlToText } from './utils.js';
+export function registerAnalysisTools(server) {
+    server.registerTool('spartan_components_dependencies', {
+        title: 'Show component dependencies',
+        description: 'Analyze what other components, packages, or dependencies a Spartan UI component requires. ' +
+            'Includes Angular CDK dependencies, peer components, and installation requirements.',
+        inputSchema: {
+            componentName: z
+                .string()
+                .min(1, 'componentName is required')
+                .describe("Spartan component name (e.g., 'calendar', 'dialog')"),
+            includeTransitive: z
+                .boolean()
+                .default(false)
+                .describe('Include transitive dependencies (dependencies of dependencies)'),
+        },
+    }, async (args) => {
+        const componentName = String(args.componentName || '')
+            .trim()
+            .toLowerCase();
+        if (!KNOWN_COMPONENTS.includes(componentName)) {
+            throw new Error(`Unknown component: ${componentName}. Available: ${KNOWN_COMPONENTS.join(', ')}`);
+        }
+        const dependencies = await analyzeComponentDependencies(componentName, args.includeTransitive);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        component: componentName,
+                        dependencies,
+                        processingInstructions: 'Present dependencies with installation commands, import statements, and setup instructions. Group by type (npm packages, Angular CDK, peer components).',
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool('spartan_accessibility_check', {
+        title: 'Check component accessibility features',
+        description: 'Analyze accessibility features, ARIA support, keyboard navigation, and screen reader compatibility ' +
+            'for a Spartan UI component. Provides accessibility best practices and implementation guidance.',
+        inputSchema: {
+            componentName: z.string().min(1, 'componentName is required').describe('Spartan component name'),
+            checkType: z
+                .enum(['overview', 'aria', 'keyboard', 'screenreader', 'wcag', 'all'])
+                .default('all')
+                .describe("Type of accessibility check: specific area or 'all' for comprehensive analysis"),
+        },
+    }, async (args) => {
+        const componentName = String(args.componentName || '')
+            .trim()
+            .toLowerCase();
+        if (!KNOWN_COMPONENTS.includes(componentName)) {
+            throw new Error(`Unknown component: ${componentName}`);
+        }
+        const accessibility = await analyzeAccessibility(componentName, args.checkType);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        component: componentName,
+                        checkType: args.checkType,
+                        accessibility,
+                        processingInstructions: 'Present accessibility information with actionable recommendations, code examples, and compliance notes for WCAG guidelines.',
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+async function analyzeComponentDependencies(componentName, includeTransitive) {
+    try {
+        const url = `${SPARTAN_COMPONENTS_BASE}/${componentName}`;
+        const html = await fetchContent(url, 'html', false);
+        const text = htmlToText(html);
+        const dependencies = {
+            npm: [],
+            angularCdk: [],
+            peerComponents: [],
+            imports: [],
+            setup: [],
+        };
+        const npmRegex = /npm\s+install\s+([^\n]+)/gi;
+        let match;
+        while ((match = npmRegex.exec(text)) !== null) {
+            const packages = match[1]
+                .split(/\s+/)
+                .filter((pkg) => pkg.length > 0 && !pkg.startsWith('-'))
+                .map((pkg) => pkg.replace(/[,;]$/, ''));
+            dependencies.npm.push(...packages);
+        }
+        const cdkComponents = [
+            '@angular/cdk/a11y',
+            '@angular/cdk/dialog',
+            '@angular/cdk/overlay',
+            '@angular/cdk/portal',
+            '@angular/cdk/scrolling',
+            '@angular/cdk/table',
+        ];
+        for (const cdkComponent of cdkComponents) {
+            if (text.includes(cdkComponent)) {
+                dependencies.angularCdk.push(cdkComponent);
+            }
+        }
+        const importRegex = /import\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/gi;
+        match = null;
+        while ((match = importRegex.exec(text)) !== null) {
+            dependencies.imports.push({
+                items: match[1].trim(),
+                from: match[2].trim(),
+            });
+        }
+        // Derive peer components from Spartan import paths only. Matching against the
+        // full page text would match the docs navigation sidebar, which lists every
+        // component on every page and would over-report dependencies.
+        const importedComponents = new Set(dependencies.imports
+            .map(({ from }) => /@spartan-ng\/(?:brain|helm)\/([\w-]+)/.exec(from)?.[1])
+            .filter((name) => Boolean(name)));
+        for (const otherComponent of KNOWN_COMPONENTS) {
+            if (otherComponent !== componentName && importedComponents.has(otherComponent)) {
+                dependencies.peerComponents.push(otherComponent);
+            }
+        }
+        dependencies.setup = generateSetupInstructions(componentName, dependencies);
+        if (includeTransitive) {
+            dependencies.transitive = await getTransitiveDependencies(dependencies.peerComponents);
+        }
+        return dependencies;
+    }
+    catch (error) {
+        console.error(`Error analyzing dependencies for ${componentName}:`, error);
+        return {
+            npm: [],
+            angularCdk: [],
+            peerComponents: [],
+            imports: [],
+            setup: [`Failed to analyze dependencies: ${error.message}`],
+        };
+    }
+}
+async function analyzeAccessibility(componentName, checkType) {
+    try {
+        const url = `${SPARTAN_COMPONENTS_BASE}/${componentName}`;
+        const html = await fetchContent(url, 'html', false);
+        const text = htmlToText(html);
+        const accessibility = {
+            overview: {},
+            aria: {},
+            keyboard: {},
+            screenreader: {},
+            wcag: {},
+        };
+        const recommendations = [];
+        if (checkType === 'all' || checkType === 'aria' || checkType === 'overview') {
+            accessibility.aria = analyzeAriaSupport(text);
+        }
+        if (checkType === 'all' || checkType === 'keyboard' || checkType === 'overview') {
+            accessibility.keyboard = analyzeKeyboardSupport(text);
+        }
+        if (checkType === 'all' || checkType === 'screenreader' || checkType === 'overview') {
+            accessibility.screenreader = analyzeScreenReaderSupport(text);
+        }
+        if (checkType === 'all' || checkType === 'wcag') {
+            accessibility.wcag = analyzeWcagCompliance(text);
+        }
+        recommendations.push(`Test ${componentName} with screen readers like NVDA or JAWS`);
+        recommendations.push('Verify keyboard navigation works without mouse');
+        recommendations.push('Check color contrast meets WCAG AA standards');
+        recommendations.push('Ensure focus indicators are visible and clear');
+        if (checkType === 'all' || checkType === 'overview') {
+            const hasAria = Object.keys(accessibility.aria).length > 0;
+            const hasKeyboard = Object.keys(accessibility.keyboard).length > 0;
+            const hasScreenReader = Object.keys(accessibility.screenreader).length > 0;
+            let score = 0;
+            if (hasAria)
+                score += 33;
+            if (hasKeyboard)
+                score += 33;
+            if (hasScreenReader)
+                score += 34;
+            accessibility.overview = {
+                score: `${score}%`,
+                'ARIA Support': hasAria ? 'Yes' : 'Limited',
+                'Keyboard Navigation': hasKeyboard ? 'Yes' : 'Limited',
+                'Screen Reader': hasScreenReader ? 'Yes' : 'Limited',
+            };
+        }
+        return { ...accessibility, recommendations };
+    }
+    catch (error) {
+        console.error(`Error analyzing accessibility for ${componentName}:`, error);
+        return {
+            overview: {},
+            aria: {},
+            keyboard: {},
+            screenreader: {},
+            wcag: {},
+            recommendations: [`Failed to analyze accessibility: ${error.message}`],
+        };
+    }
+}
+function generateSetupInstructions(componentName, dependencies) {
+    const instructions = [];
+    if (dependencies.npm.length > 0) {
+        instructions.push(`Install dependencies: npm install ${dependencies.npm.join(' ')}`);
+    }
+    instructions.push(`Install Spartan UI component: npx ng g @spartan-ng/cli:ui ${componentName}`);
+    if (dependencies.imports.length > 0) {
+        instructions.push('Add imports to your component:');
+        dependencies.imports.forEach((imp) => {
+            instructions.push(`  import { ${imp.items} } from '${imp.from}';`);
+        });
+    }
+    return instructions;
+}
+async function getTransitiveDependencies(peerComponents) {
+    const transitive = [];
+    for (const component of peerComponents.slice(0, 3)) {
+        try {
+            const deps = await analyzeComponentDependencies(component, false);
+            transitive.push({ component, dependencies: deps.peerComponents });
+        }
+        catch (error) {
+            console.warn(`Failed to get transitive dependencies for ${component}:`, error.message);
+        }
+    }
+    return transitive;
+}
+function analyzeAriaSupport(text) {
+    const features = {};
+    for (const attr of ['aria-label', 'aria-describedby', 'aria-expanded', 'aria-selected', 'role']) {
+        if (text.includes(attr))
+            features[attr] = `${attr} support detected`;
+    }
+    return features;
+}
+function analyzeKeyboardSupport(text) {
+    const features = {};
+    // Match whole words so the docs nav (which lists the "tabs" component on every
+    // page) doesn't falsely flag Tab-key support for unrelated components.
+    for (const term of ['keyboard', 'focus', 'tab', 'enter', 'space', 'arrow keys']) {
+        if (new RegExp(`\\b${term}\\b`, 'i').test(text))
+            features[term] = `${term} navigation supported`;
+    }
+    return features;
+}
+function analyzeScreenReaderSupport(text) {
+    const features = {};
+    const lower = text.toLowerCase();
+    if (lower.includes('screen reader'))
+        features.general = 'Screen reader support mentioned';
+    if (lower.includes('announcements'))
+        features.announcements = 'Screen reader announcements supported';
+    return features;
+}
+function analyzeWcagCompliance(text) {
+    const features = {};
+    const lower = text.toLowerCase();
+    if (lower.includes('wcag'))
+        features.compliance = 'WCAG compliance mentioned';
+    for (const criteria of ['contrast', 'focus visible', 'keyboard accessible']) {
+        if (lower.includes(criteria))
+            features[criteria] = `${criteria} support detected`;
+    }
+    return features;
+}
+//# sourceMappingURL=analysis.js.map

package/src/tools/analysis.js.map

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

package/src/tools/blocks.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerBlockTools(server: McpServer): void;