@shuji-bonji/w3c-mcp 0.1.0

package/dist/data/loader.js

@@ -0,0 +1,165 @@
+/**
+ * Data loader for web-specs and webref packages
+ *
+ * Performance improvements:
+ * - Lazy loading with singleton pattern
+ * - Promise-based caching to prevent duplicate loads
+ * - Parallel loading support
+ * - Memory-efficient data structures
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+// ============================================
+// Singleton cache with Promise-based loading
+// Prevents duplicate loads when multiple requests come in simultaneously
+// ============================================
+let specsPromise = null;
+let idlPromise = null;
+let cssPromise = null;
+let elementsPromise = null;
+// Shortname index for O(1) lookup
+let specsIndex = null;
+let seriesIndex = null;
+/**
+ * Load specs with singleton promise pattern
+ * Multiple simultaneous calls share the same loading promise
+ */
+export async function loadSpecs() {
+    if (!specsPromise) {
+        specsPromise = Promise.resolve().then(() => {
+            const specs = require('web-specs');
+            // Build indices for faster lookup
+            buildSpecIndices(specs);
+            return specs;
+        });
+    }
+    return specsPromise;
+}
+/**
+ * Build indices for O(1) spec lookup by shortname
+ */
+function buildSpecIndices(specs) {
+    specsIndex = new Map();
+    seriesIndex = new Map();
+    for (const spec of specs) {
+        specsIndex.set(spec.shortname, spec);
+        if (spec.series?.shortname) {
+            // Only set if not already set (prefer exact match)
+            if (!seriesIndex.has(spec.series.shortname)) {
+                seriesIndex.set(spec.series.shortname, spec);
+            }
+        }
+    }
+}
+/**
+ * Find a spec by shortname - O(1) with index
+ */
+export async function findSpec(shortname) {
+    await loadSpecs(); // Ensure indices are built
+    // Try exact match first (O(1))
+    if (specsIndex?.has(shortname)) {
+        return specsIndex.get(shortname);
+    }
+    // Try series shortname (O(1))
+    if (seriesIndex?.has(shortname)) {
+        return seriesIndex.get(shortname);
+    }
+    // Fallback to partial match (O(n) - only when necessary)
+    const specs = await loadSpecs();
+    return specs.find(s => s.shortname.includes(shortname) ||
+        shortname.includes(s.shortname));
+}
+/**
+ * Load WebIDL with singleton promise pattern
+ */
+export async function loadWebIDLRaw() {
+    if (!idlPromise) {
+        idlPromise = (async () => {
+            try {
+                const { readFileSync } = await import('fs');
+                const webrefIdl = require('@webref/idl');
+                const idlFiles = await webrefIdl.listAll();
+                const result = {};
+                for (const [shortname, file] of Object.entries(idlFiles)) {
+                    try {
+                        result[shortname] = readFileSync(file.path, 'utf8');
+                    }
+                    catch {
+                        // Skip files that can't be read
+                    }
+                }
+                return result;
+            }
+            catch (error) {
+                console.error('Error loading raw WebIDL:', error);
+                return {};
+            }
+        })();
+    }
+    return idlPromise;
+}
+/**
+ * Load CSS data with singleton promise pattern
+ */
+export async function loadCSS() {
+    if (!cssPromise) {
+        cssPromise = (async () => {
+            try {
+                const webrefCss = require('@webref/css');
+                const data = await webrefCss.listAll();
+                return data;
+            }
+            catch (error) {
+                console.error('Error loading CSS data:', error);
+                return { properties: [], functions: [], types: [], selectors: [], atrules: [] };
+            }
+        })();
+    }
+    return cssPromise;
+}
+/**
+ * Load elements data with singleton promise pattern
+ */
+export async function loadElements() {
+    if (!elementsPromise) {
+        elementsPromise = (async () => {
+            try {
+                const webrefElements = require('@webref/elements');
+                const data = await webrefElements.listAll();
+                return data;
+            }
+            catch (error) {
+                console.error('Error loading elements data:', error);
+                return {};
+            }
+        })();
+    }
+    return elementsPromise;
+}
+// ============================================
+// Preload function for warming up cache
+// ============================================
+/**
+ * Preload all data in parallel
+ * Call this at server startup for better first-request performance
+ */
+export async function preloadAll() {
+    await Promise.all([
+        loadSpecs(),
+        loadWebIDLRaw(),
+        loadCSS(),
+        loadElements()
+    ]);
+}
+// ============================================
+// Cache invalidation (for testing/development)
+// ============================================
+export function clearCache() {
+    specsPromise = null;
+    idlPromise = null;
+    cssPromise = null;
+    elementsPromise = null;
+    specsIndex = null;
+    seriesIndex = null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/data/loader.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Custom error classes for W3C MCP Server
+ */
+import { z } from 'zod';
+/**
+ * Base class for W3C MCP errors
+ */
+export declare class W3CMCPError extends Error {
+    constructor(message: string);
+}
+/**
+ * Spec not found error with suggestions
+ */
+export declare class SpecNotFoundError extends W3CMCPError {
+    suggestions?: string[];
+    constructor(shortname: string, suggestions?: string[]);
+}
+/**
+ * WebIDL not found error
+ */
+export declare class WebIDLNotFoundError extends W3CMCPError {
+    constructor(shortname: string);
+}
+/**
+ * CSS data not found error
+ */
+export declare class CSSNotFoundError extends W3CMCPError {
+    constructor(spec: string, availableSpecs?: string[]);
+}
+/**
+ * Elements data not found error
+ */
+export declare class ElementsNotFoundError extends W3CMCPError {
+    constructor(spec: string, availableSpecs?: string[]);
+}
+/**
+ * Validation error wrapper
+ */
+export declare class ValidationError extends W3CMCPError {
+    zodError: z.ZodError;
+    constructor(zodError: z.ZodError);
+}
+/**
+ * Format error response for MCP
+ */
+export declare function formatErrorResponse(error: unknown): {
+    text: string;
+    errorType: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IACzC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAElB,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAQtD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;CAOpD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;CAOpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IACvC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;gBAEhB,QAAQ,EAAE,CAAC,CAAC,QAAQ;CAMjC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA4CvF"}

package/dist/errors/index.js

@@ -0,0 +1,116 @@
+/**
+ * Custom error classes for W3C MCP Server
+ */
+/**
+ * Base class for W3C MCP errors
+ */
+export class W3CMCPError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'W3CMCPError';
+    }
+}
+/**
+ * Spec not found error with suggestions
+ */
+export class SpecNotFoundError extends W3CMCPError {
+    suggestions;
+    constructor(shortname, suggestions) {
+        const message = suggestions?.length
+            ? `Specification "${shortname}" not found. Did you mean: ${suggestions.join(', ')}?`
+            : `Specification "${shortname}" not found.`;
+        super(message);
+        this.name = 'SpecNotFoundError';
+        this.suggestions = suggestions;
+    }
+}
+/**
+ * WebIDL not found error
+ */
+export class WebIDLNotFoundError extends W3CMCPError {
+    constructor(shortname) {
+        super(`WebIDL not found for "${shortname}". This specification might not have WebIDL definitions.`);
+        this.name = 'WebIDLNotFoundError';
+    }
+}
+/**
+ * CSS data not found error
+ */
+export class CSSNotFoundError extends W3CMCPError {
+    constructor(spec, availableSpecs) {
+        const message = availableSpecs?.length
+            ? `CSS data not found for "${spec}". Available CSS specs: ${availableSpecs.slice(0, 10).join(', ')}...`
+            : `CSS data not found for "${spec}".`;
+        super(message);
+        this.name = 'CSSNotFoundError';
+    }
+}
+/**
+ * Elements data not found error
+ */
+export class ElementsNotFoundError extends W3CMCPError {
+    constructor(spec, availableSpecs) {
+        const message = availableSpecs?.length
+            ? `Elements data not found for "${spec}". Available specs: ${availableSpecs.join(', ')}`
+            : `Elements data not found for "${spec}".`;
+        super(message);
+        this.name = 'ElementsNotFoundError';
+    }
+}
+/**
+ * Validation error wrapper
+ */
+export class ValidationError extends W3CMCPError {
+    zodError;
+    constructor(zodError) {
+        const issues = zodError.issues.map(i => `${i.path.join('.')}: ${i.message}`).join('; ');
+        super(`Validation error: ${issues}`);
+        this.name = 'ValidationError';
+        this.zodError = zodError;
+    }
+}
+/**
+ * Format error response for MCP
+ */
+export function formatErrorResponse(error) {
+    if (error instanceof ValidationError) {
+        return {
+            text: JSON.stringify({
+                error: 'ValidationError',
+                message: error.message,
+                issues: error.zodError.issues
+            }, null, 2),
+            errorType: 'ValidationError'
+        };
+    }
+    if (error instanceof SpecNotFoundError) {
+        return {
+            text: JSON.stringify({
+                error: 'SpecNotFoundError',
+                message: error.message,
+                suggestions: error.suggestions
+            }, null, 2),
+            errorType: 'SpecNotFoundError'
+        };
+    }
+    if (error instanceof W3CMCPError) {
+        return {
+            text: JSON.stringify({
+                error: error.name,
+                message: error.message
+            }, null, 2),
+            errorType: error.name
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            text: `Error: ${error.message}`,
+            errorType: 'Error'
+        };
+    }
+    return {
+        text: 'An unknown error occurred',
+        errorType: 'UnknownError'
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * W3C MCP Server
+ * Provides access to W3C/WHATWG/IETF web specifications via MCP protocol
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+/**
+ * W3C MCP Server
+ * Provides access to W3C/WHATWG/IETF web specifications via MCP protocol
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { listSpecs } from './tools/list-specs.js';
+import { getSpec, getSpecDependencies } from './tools/get-spec.js';
+import { searchSpecs } from './tools/search-specs.js';
+import { getWebIDL, listWebIDLSpecs } from './tools/get-webidl.js';
+import { getCSSProperties, searchCSSProperty, listCSSSpecs } from './tools/get-css.js';
+import { getElements, searchElement, listElementSpecs } from './tools/get-elements.js';
+import { getPwaSpecs, getCorePwaSpecs } from './tools/get-pwa-specs.js';
+import { preloadAll } from './data/loader.js';
+// Validation schemas
+import { ListSpecsSchema, GetSpecSchema, SearchSpecsSchema, GetWebIDLSchema, GetCSSPropertiesSchema, GetElementsSchema, GetPwaSpecsSchema, GetSpecDependenciesSchema, validateInput, } from './schemas/index.js';
+// Error handling
+import { formatErrorResponse, ValidationError } from './errors/index.js';
+// Logging
+import { info, logToolCall, logToolResult, PerformanceTimer } from './utils/logger.js';
+const server = new Server({
+    name: 'w3c-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Tool definitions
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'list_w3c_specs',
+            description: 'List W3C/WHATWG/IETF web specifications with optional filtering by organization, keyword, or category',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization: {
+                        type: 'string',
+                        enum: ['W3C', 'WHATWG', 'IETF', 'all'],
+                        description: 'Filter by standards organization',
+                    },
+                    keyword: {
+                        type: 'string',
+                        description: 'Filter by keyword in title or shortname',
+                    },
+                    category: {
+                        type: 'string',
+                        description: 'Filter by category (e.g., "browser")',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of results (default: 50)',
+                    },
+                },
+            },
+        },
+        {
+            name: 'get_w3c_spec',
+            description: 'Get detailed information about a specific web specification including URLs, status, repository, and test info',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    shortname: {
+                        type: 'string',
+                        description: 'Specification shortname (e.g., "service-workers", "appmanifest", "fetch", "dom")',
+                    },
+                },
+                required: ['shortname'],
+            },
+        },
+        {
+            name: 'search_w3c_specs',
+            description: 'Search web specifications by query string, searching in title, shortname, and description',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query (e.g., "service worker", "manifest", "storage")',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of results (default: 20)',
+                    },
+                },
+                required: ['query'],
+            },
+        },
+        {
+            name: 'get_webidl',
+            description: 'Get WebIDL interface definitions for a specification. WebIDL defines the JavaScript APIs.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    shortname: {
+                        type: 'string',
+                        description: 'Specification shortname (e.g., "service-workers", "fetch", "dom")',
+                    },
+                },
+                required: ['shortname'],
+            },
+        },
+        {
+            name: 'list_webidl_specs',
+            description: 'List all specifications that have WebIDL definitions available',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
+        {
+            name: 'get_css_properties',
+            description: 'Get CSS property definitions from a specific spec or all specs',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    spec: {
+                        type: 'string',
+                        description: 'Specification shortname (e.g., "css-grid-1", "css-flexbox-1"). If omitted, returns all CSS properties.',
+                    },
+                    property: {
+                        type: 'string',
+                        description: 'Search for a specific CSS property by name',
+                    },
+                },
+            },
+        },
+        {
+            name: 'list_css_specs',
+            description: 'List all CSS specifications that have property definitions available',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
+        {
+            name: 'get_html_elements',
+            description: 'Get HTML element definitions from a specific spec or all specs',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    spec: {
+                        type: 'string',
+                        description: 'Specification shortname (e.g., "html", "svg"). If omitted, returns all elements.',
+                    },
+                    element: {
+                        type: 'string',
+                        description: 'Search for a specific element by name (e.g., "video", "canvas")',
+                    },
+                },
+            },
+        },
+        {
+            name: 'list_element_specs',
+            description: 'List all specifications that have HTML element definitions available',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
+        {
+            name: 'get_pwa_specs',
+            description: 'Get all Progressive Web App (PWA) related specifications including Service Worker, Web App Manifest, Push API, Background Sync, etc.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    coreOnly: {
+                        type: 'boolean',
+                        description: 'If true, return only the core PWA specs (Service Worker, Manifest, Push, Notifications)',
+                    },
+                },
+            },
+        },
+        {
+            name: 'get_spec_dependencies',
+            description: 'Get dependency information for a specification (which specs it depends on and which depend on it)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    shortname: {
+                        type: 'string',
+                        description: 'Specification shortname',
+                    },
+                },
+                required: ['shortname'],
+            },
+        },
+    ],
+}));
+// Tool execution with validation and error handling
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const timer = new PerformanceTimer(`tool:${name}`);
+    logToolCall(name, args);
+    try {
+        let result;
+        switch (name) {
+            case 'list_w3c_specs': {
+                const validation = validateInput(ListSpecsSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = await listSpecs(validation.data);
+                break;
+            }
+            case 'get_w3c_spec': {
+                const validation = validateInput(GetSpecSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = await getSpec(validation.data.shortname);
+                break;
+            }
+            case 'search_w3c_specs': {
+                const validation = validateInput(SearchSpecsSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = await searchSpecs(validation.data.query, validation.data.limit);
+                break;
+            }
+            case 'get_webidl': {
+                const validation = validateInput(GetWebIDLSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                const idl = await getWebIDL(validation.data.shortname);
+                timer.end();
+                logToolResult(name, idl.length);
+                return { content: [{ type: 'text', text: idl }] };
+            }
+            case 'list_webidl_specs': {
+                result = await listWebIDLSpecs();
+                break;
+            }
+            case 'get_css_properties': {
+                const validation = validateInput(GetCSSPropertiesSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = validation.data.property
+                    ? await searchCSSProperty(validation.data.property)
+                    : await getCSSProperties(validation.data.spec);
+                break;
+            }
+            case 'list_css_specs': {
+                result = await listCSSSpecs();
+                break;
+            }
+            case 'get_html_elements': {
+                const validation = validateInput(GetElementsSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = validation.data.element
+                    ? await searchElement(validation.data.element)
+                    : await getElements(validation.data.spec);
+                break;
+            }
+            case 'list_element_specs': {
+                result = await listElementSpecs();
+                break;
+            }
+            case 'get_pwa_specs': {
+                const validation = validateInput(GetPwaSpecsSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = validation.data.coreOnly ? await getCorePwaSpecs() : await getPwaSpecs();
+                break;
+            }
+            case 'get_spec_dependencies': {
+                const validation = validateInput(GetSpecDependenciesSchema, args);
+                if (!validation.success)
+                    throw new ValidationError(validation.error);
+                result = await getSpecDependencies(validation.data.shortname);
+                break;
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        const text = JSON.stringify(result, null, 2);
+        timer.end();
+        logToolResult(name, text.length);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        timer.end();
+        const formatted = formatErrorResponse(error);
+        return {
+            content: [{ type: 'text', text: formatted.text }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    info('W3C MCP Server: Preloading data...');
+    const timer = new PerformanceTimer('preload');
+    await preloadAll();
+    const loadTime = timer.end();
+    info(`W3C MCP Server: Data loaded in ${loadTime}ms`);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    info('W3C MCP Server running on stdio');
+}
+main().catch((err) => {
+    console.error('Failed to start server:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map