@amedia/brick-mcp 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/components/brick-helloworld.md +112 -143
- package/data/components/brick-icon.md +92 -139
- package/data/components/brick-icons.md +114 -318
- package/data/components/brick-mcp.md +104 -161
- package/data/components/brick-template.md +145 -146
- package/data/components-metadata.json +31 -31
- package/data/tokens.json +232 -227
- package/dist/data/components/brick-helloworld.md +112 -143
- package/dist/data/components/brick-icon.md +92 -139
- package/dist/data/components/brick-icons.md +114 -318
- package/dist/data/components/brick-mcp.md +104 -161
- package/dist/data/components/brick-template.md +145 -146
- package/dist/data/components-metadata.json +31 -31
- package/dist/data/tokens.json +232 -227
- package/dist/http.js +4 -2
- package/dist/http.js.map +3 -3
- package/dist/index.js +4 -2
- package/dist/index.js.map +3 -3
- package/package.json +34 -34
- package/scripts/check-docs-versions.js +10 -3
- package/scripts/generate-data.js +2 -2
package/dist/http.js
CHANGED
|
@@ -11,6 +11,10 @@ import { z } from "zod";
|
|
|
11
11
|
import { readFile as readFile2 } from "node:fs/promises";
|
|
12
12
|
import { join as join3 } from "node:path";
|
|
13
13
|
|
|
14
|
+
// src/extractors/packageScanner.ts
|
|
15
|
+
import { readFile } from "node:fs/promises";
|
|
16
|
+
import { join as join2 } from "node:path";
|
|
17
|
+
|
|
14
18
|
// src/utils/dataPath.ts
|
|
15
19
|
import { accessSync } from "node:fs";
|
|
16
20
|
import { dirname, join } from "node:path";
|
|
@@ -39,8 +43,6 @@ function getDataPath() {
|
|
|
39
43
|
}
|
|
40
44
|
|
|
41
45
|
// src/extractors/packageScanner.ts
|
|
42
|
-
import { readFile } from "node:fs/promises";
|
|
43
|
-
import { join as join2 } from "node:path";
|
|
44
46
|
async function scanAllPackages() {
|
|
45
47
|
try {
|
|
46
48
|
const metadataPath = join2(getDataPath(), "components-metadata.json");
|
package/dist/http.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../src/http.ts", "../src/server.ts", "../src/tools/getComponentDocs.ts", "../src/
|
|
4
|
-
"sourcesContent": ["/**\n * HTTP server entry point for local development only\n * Uses Fastify and SSE transport for MCP communication\n */\n\nimport cors from '@fastify/cors';\nimport { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';\nimport Fastify from 'fastify';\n\nimport { createServer } from './server.ts';\n\nconst PORT = 3000;\nconst HOST = 'localhost';\n\nconst fastify = Fastify({\n logger: {\n level: 'info',\n },\n});\n\n// Store active transports and servers by sessionId\nconst activeTransports = new Map<string, SSEServerTransport>();\nconst activeMcpServers = new Map<string, ReturnType<typeof createServer>>();\n\n// Enable CORS for local development\nawait fastify.register(cors, {\n origin: true,\n credentials: true,\n});\n\n// Health check endpoint\nfastify.get('/health', async () => {\n return { status: 'ok' };\n});\n\n// SSE endpoint for MCP communication\nfastify.get('/sse', async (_request, reply) => {\n // Prevent Fastify from automatically sending a response\n reply.hijack();\n\n // Create a new MCP server instance for this connection\n const mcpServer = createServer();\n\n // Create SSE transport (this will handle headers internally)\n const transport = new SSEServerTransport('/message', reply.raw);\n\n // Handle the SSE connection (this calls transport.start() which writes headers)\n await mcpServer.connect(transport);\n\n // Store the transport and server by sessionId for POST message handling\n // The sessionId is available after the transport starts via the public getter\n const sessionId = transport.sessionId;\n activeTransports.set(sessionId, transport);\n activeMcpServers.set(sessionId, mcpServer);\n\n // Clean up when the connection closes\n reply.raw.on('close', async () => {\n activeTransports.delete(sessionId);\n const server = activeMcpServers.get(sessionId);\n if (server) {\n await server.close();\n activeMcpServers.delete(sessionId);\n }\n });\n});\n\n// POST endpoint for messages\nfastify.post<{\n Querystring: { sessionId: string };\n}>('/message', async (request, reply) => {\n // Prevent Fastify from automatically sending a response\n reply.hijack();\n\n // Extract sessionId from query parameters (now properly typed)\n const { sessionId } = request.query;\n\n // Find the transport for this session\n const transport = activeTransports.get(sessionId);\n\n if (!transport) {\n reply.raw.writeHead(404, { 'Content-Type': 'application/json' });\n reply.raw.end(JSON.stringify({ error: 'Session not found' }));\n return;\n }\n\n // Let the transport handle the POST message\n await transport.handlePostMessage(request.raw, reply.raw, request.body);\n});\n\n// Start the server\ntry {\n await fastify.listen({ port: PORT, host: HOST });\n console.log(`Brick MCP HTTP server listening on http://${HOST}:${PORT}`);\n console.log(`SSE endpoint: http://${HOST}:${PORT}/sse`);\n} catch (err) {\n fastify.log.error(err);\n process.exit(1);\n}\n", "/**\n * MCP server setup and registration\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { getComponentDocs } from './tools/getComponentDocs.ts';\nimport { getDesignTokens } from './tools/getDesignTokens.ts';\nimport { listComponents } from './tools/listComponents.ts';\n\n/**\n * Create and configure the MCP server\n */\nexport function createServer(): McpServer {\n // Create an MCP server\n const server = new McpServer({\n name: 'brick-design-system',\n version: '1.0.0',\n });\n\n // Register list-components tool\n server.registerTool(\n 'list-components',\n {\n title: 'List Brick Components',\n description:\n 'List all available Brick components with metadata. Optionally filter by category, tag, or name.',\n inputSchema: z.object({\n filter: z\n .string()\n .optional()\n .describe('Optional filter by category, tag, or name'),\n }),\n } as const,\n async ({ filter }: { filter?: string }) => {\n const result = await listComponents({ filter });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-component-docs tool\n server.registerTool(\n 'get-component-docs',\n {\n title: 'Get Component Documentation',\n description:\n 'Retrieve detailed documentation for specific Brick component(s) including props, events, examples, and accessibility information.',\n inputSchema: z.object({\n components: z\n .array(z.string())\n .describe(\n 'Array of component names (e.g., [\"brick-button\", \"brick-modal\"])'\n ),\n }),\n } as const,\n async ({ components }: { components: string[] }) => {\n const result = await getComponentDocs({ components });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-design-tokens tool\n server.registerTool(\n 'get-design-tokens',\n {\n title: 'Get Design Tokens',\n description:\n 'Access design tokens from brick-tokens. Optionally filter by category (colors, spacing, typography, shadows, borders).',\n inputSchema: z.object({\n category: z\n .enum(['colors', 'spacing', 'typography', 'shadows', 'borders'])\n .optional()\n .describe('Filter tokens by category'),\n }),\n } as const,\n async ({\n category,\n }: {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n }) => {\n const result = await getDesignTokens({ category });\n\n return {\n content: [\n {\n type: 'text',\n text: result,\n },\n ],\n };\n }\n );\n\n return server;\n}\n", "/**\n * Get Component Docs tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\nimport { loadComponentData } from '../extractors/packageScanner.ts';\n\nexport interface GetComponentDocsInput {\n components: string[]; // e.g., [\"brick-button\", \"brick-modal\"]\n}\n\nexport interface GetComponentDocsOutput {\n docs: string[];\n}\n\n/**\n * Load markdown documentation for a component\n */\nasync function loadComponentMarkdown(\n componentName: string\n): Promise<string | undefined> {\n try {\n const markdownPath = join(\n getDataPath(),\n 'components',\n `${componentName}.md`\n );\n const content = await readFile(markdownPath, 'utf-8');\n return content;\n } catch (error) {\n console.error(`Error loading markdown for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Get detailed documentation for specific component(s)\n */\nexport async function getComponentDocs(\n input: GetComponentDocsInput\n): Promise<GetComponentDocsOutput> {\n // Load markdown documentation for each requested component\n const docsPromises = input.components.map(async (componentName) => {\n const md = await loadComponentMarkdown(componentName);\n if (!md) {\n const json = await loadComponentData(componentName);\n return json ? JSON.stringify(json) : undefined;\n }\n return md;\n });\n\n const docsResults = await Promise.all(docsPromises);\n\n // Filter out any components that failed to load\n const docs = docsResults.filter((doc): doc is string => doc !== undefined);\n\n return { docs };\n}\n", "/**\n * Utility for finding the data directory path\n * Works both in development (from src/) and production (from dist/)\n */\n\nimport { accessSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Get the path to the data directory\n * When running from dist/, looks for dist/data\n * When running from src/, looks for package root data\n */\nexport function getDataPath(): string {\n const currentFilePath = fileURLToPath(import.meta.url);\n let dir = dirname(currentFilePath);\n\n // First check if there's a data directory in the same parent as the current file\n // This handles the dist/data case when running from dist/\n const localDataPath = join(dir, 'data');\n try {\n accessSync(localDataPath);\n return localDataPath;\n } catch {\n // Continue to package root search\n }\n\n // Walk up the directory tree to find package root (where package.json exists)\n for (let i = 0; i < 5; i++) {\n try {\n const testPath = join(dir, 'package.json');\n accessSync(testPath);\n return join(dir, 'data');\n } catch {\n // Go up one level\n const parent = dirname(dir);\n if (parent === dir) break; // Reached filesystem root\n dir = parent;\n }\n }\n\n return join(dirname(currentFilePath), '..', '..', 'data');\n}\n", "/**\n * Package scanner for discovering Brick components\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { type BrickComponent, type BrickComponentMetadata } from '../types.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\n/**\n * Load all component metadata (lightweight, for listing)\n */\nexport async function scanAllPackages(): Promise<BrickComponentMetadata[]> {\n try {\n const metadataPath = join(getDataPath(), 'components-metadata.json');\n const content = await readFile(metadataPath, 'utf-8');\n const metadata: BrickComponentMetadata[] = JSON.parse(content);\n return metadata;\n } catch (error) {\n console.error('Error loading component metadata:', error);\n return [];\n }\n}\n\n/**\n * Load full component data for a specific component\n */\nexport async function loadComponentData(\n componentName: string\n): Promise<BrickComponent | undefined> {\n try {\n const componentPath = join(\n getDataPath(),\n 'components',\n `${componentName}.json`\n );\n const content = await readFile(componentPath, 'utf-8');\n const component: BrickComponent = JSON.parse(content);\n return component;\n } catch (error) {\n console.error(`Error loading component data for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Filter components by category or tag\n */\nexport function filterComponents(\n components: BrickComponentMetadata[],\n filter?: string\n): BrickComponentMetadata[] {\n if (!filter) {\n return components;\n }\n\n const filterLower = filter.toLowerCase();\n\n return components.filter((component) => {\n // Match against name\n if (component.name.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against category\n if (component.category?.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against tags\n if (\n component.tags?.some((tag) => tag.toLowerCase().includes(filterLower))\n ) {\n return true;\n }\n\n return false;\n });\n}\n", "/**\n * Get Design Tokens tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface DesignToken {\n path: string;\n name: string;\n type: string;\n value: string;\n description?: string;\n cssVariable: string;\n}\n\nexport interface GetDesignTokensInput {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n}\n\n/**\n * Category filter definitions mapping category names to path prefixes\n */\nconst CATEGORY_PREFIXES: Record<string, string[]> = {\n colors: ['color.'],\n spacing: ['spacing.'],\n typography: ['typography.'],\n shadows: ['box-shadow.'],\n borders: ['border-width.', 'border-radius.', 'border.'],\n};\n\n/**\n * Get the path to the bundled tokens data\n */\nfunction getTokensDataPath(): string {\n return join(getDataPath(), 'tokens.json');\n}\n\n/**\n * Load all tokens from bundled JSON data\n */\nasync function loadAllTokens(): Promise<DesignToken[]> {\n try {\n const dataPath = getTokensDataPath();\n const content = await readFile(dataPath, 'utf-8');\n return JSON.parse(content);\n } catch (error) {\n console.error('Error loading tokens data:', error);\n return [];\n }\n}\n\n/**\n * Check if a token belongs to a given category\n */\nfunction tokenMatchesCategory(token: DesignToken, category: string): boolean {\n const prefixes = CATEGORY_PREFIXES[category];\n if (!prefixes) return false;\n const path = token.path.toLowerCase();\n return prefixes.some((prefix) => path.startsWith(prefix));\n}\n\n/**\n * Format tokens as a compact text listing\n */\nfunction formatTokensCompact(tokens: DesignToken[]): string {\n return tokens\n .map((t) => {\n const base = `${t.cssVariable}: ${t.value}`;\n return t.description ? `${base} \u2014 ${t.description}` : base;\n })\n .join('\\n');\n}\n\n/**\n * Build a category summary with counts and example token paths\n */\nfunction buildCategorySummary(allTokens: DesignToken[]): string {\n const lines: string[] = ['Available token categories:'];\n\n for (const category of Object.keys(CATEGORY_PREFIXES)) {\n const matching = allTokens.filter((t) => tokenMatchesCategory(t, category));\n const count = matching.length;\n const examples = matching\n .slice(0, 3)\n .map((t) => t.path)\n .join(', ');\n const suffix = examples ? ` (${examples}, ...)` : '';\n lines.push(`- ${category}: ${count} tokens${suffix}`);\n }\n\n lines.push('', 'Call with a specific category to see tokens.');\n return lines.join('\\n');\n}\n\n/**\n * Get design tokens with optional filtering.\n * Returns a compact text string to minimize context window usage.\n */\nexport async function getDesignTokens(\n input: GetDesignTokensInput\n): Promise<string> {\n const allTokens = await loadAllTokens();\n\n // No category: return summary instead of dumping all tokens\n if (!input.category) {\n return buildCategorySummary(allTokens);\n }\n\n const filteredTokens = allTokens.filter((t) =>\n tokenMatchesCategory(t, input.category!)\n );\n\n const header = `${input.category} tokens (${filteredTokens.length} tokens). Values shown are examples from one theme. Actual values vary across themes (alfa, bravo, charlie, nettavisen, alt). Use the CSS variable for theme-aware styling.\\n`;\n return header + formatTokensCompact(filteredTokens);\n}\n", "/**\n * List Components tool implementation\n */\n\nimport {\n filterComponents,\n scanAllPackages,\n} from '../extractors/packageScanner.ts';\nimport type { BrickComponentMetadata } from '../types.ts';\n\nexport interface ListComponentsInput {\n filter?: string;\n}\n\nexport interface ListComponentsOutput {\n components: BrickComponentMetadata[];\n}\n\n/**\n * List all available Brick components with optional filtering\n */\nexport async function listComponents(\n input: ListComponentsInput\n): Promise<ListComponentsOutput> {\n // Scan all packages in the monorepo (returns lightweight metadata)\n const allComponents = await scanAllPackages();\n\n // Apply filter if provided\n const components = filterComponents(allComponents, input.filter);\n\n return {\n components,\n };\n}\n"],
|
|
5
|
-
"mappings": ";AAKA,OAAO,UAAU;AACjB,SAAS,0BAA0B;AACnC,OAAO,aAAa;;;ACHpB,SAAS,iBAAiB;AAC1B,SAAS,SAAS;;;ACDlB,SAAS,YAAAA,iBAAgB;AACzB,SAAS,QAAAC,aAAY;;;ACArB,SAAS,kBAAkB;AAC3B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAOvB,SAAS,cAAsB;AACpC,QAAM,kBAAkB,cAAc,YAAY,GAAG;AACrD,MAAI,MAAM,QAAQ,eAAe;AAIjC,QAAM,gBAAgB,KAAK,KAAK,MAAM;AACtC,MAAI;AACF,eAAW,aAAa;AACxB,WAAO;AAAA,EACT,QAAQ;AAAA,EAER;AAGA,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAI;AACF,YAAM,WAAW,KAAK,KAAK,cAAc;AACzC,iBAAW,QAAQ;AACnB,aAAO,KAAK,KAAK,MAAM;AAAA,IACzB,QAAQ;AAEN,YAAM,SAAS,QAAQ,GAAG;AAC1B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AAAA,EACF;AAEA,SAAO,KAAK,QAAQ,eAAe,GAAG,MAAM,MAAM,MAAM;AAC1D;;;
|
|
3
|
+
"sources": ["../src/http.ts", "../src/server.ts", "../src/tools/getComponentDocs.ts", "../src/extractors/packageScanner.ts", "../src/utils/dataPath.ts", "../src/tools/getDesignTokens.ts", "../src/tools/listComponents.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * HTTP server entry point for local development only\n * Uses Fastify and SSE transport for MCP communication\n */\n\nimport cors from '@fastify/cors';\nimport { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';\nimport Fastify from 'fastify';\n\nimport { createServer } from './server.ts';\n\nconst PORT = 3000;\nconst HOST = 'localhost';\n\nconst fastify = Fastify({\n logger: {\n level: 'info',\n },\n});\n\n// Store active transports and servers by sessionId\nconst activeTransports = new Map<string, SSEServerTransport>();\nconst activeMcpServers = new Map<string, ReturnType<typeof createServer>>();\n\n// Enable CORS for local development\nawait fastify.register(cors, {\n origin: true,\n credentials: true,\n});\n\n// Health check endpoint\nfastify.get('/health', async () => {\n return { status: 'ok' };\n});\n\n// SSE endpoint for MCP communication\nfastify.get('/sse', async (_request, reply) => {\n // Prevent Fastify from automatically sending a response\n reply.hijack();\n\n // Create a new MCP server instance for this connection\n const mcpServer = createServer();\n\n // Create SSE transport (this will handle headers internally)\n const transport = new SSEServerTransport('/message', reply.raw);\n\n // Handle the SSE connection (this calls transport.start() which writes headers)\n await mcpServer.connect(transport);\n\n // Store the transport and server by sessionId for POST message handling\n // The sessionId is available after the transport starts via the public getter\n const sessionId = transport.sessionId;\n activeTransports.set(sessionId, transport);\n activeMcpServers.set(sessionId, mcpServer);\n\n // Clean up when the connection closes\n reply.raw.on('close', async () => {\n activeTransports.delete(sessionId);\n const server = activeMcpServers.get(sessionId);\n if (server) {\n await server.close();\n activeMcpServers.delete(sessionId);\n }\n });\n});\n\n// POST endpoint for messages\nfastify.post<{\n Querystring: { sessionId: string };\n}>('/message', async (request, reply) => {\n // Prevent Fastify from automatically sending a response\n reply.hijack();\n\n // Extract sessionId from query parameters (now properly typed)\n const { sessionId } = request.query;\n\n // Find the transport for this session\n const transport = activeTransports.get(sessionId);\n\n if (!transport) {\n reply.raw.writeHead(404, { 'Content-Type': 'application/json' });\n reply.raw.end(JSON.stringify({ error: 'Session not found' }));\n return;\n }\n\n // Let the transport handle the POST message\n await transport.handlePostMessage(request.raw, reply.raw, request.body);\n});\n\n// Start the server\ntry {\n await fastify.listen({ port: PORT, host: HOST });\n console.log(`Brick MCP HTTP server listening on http://${HOST}:${PORT}`);\n console.log(`SSE endpoint: http://${HOST}:${PORT}/sse`);\n} catch (err) {\n fastify.log.error(err);\n process.exit(1);\n}\n", "/**\n * MCP server setup and registration\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { getComponentDocs } from './tools/getComponentDocs.ts';\nimport { getDesignTokens } from './tools/getDesignTokens.ts';\nimport { listComponents } from './tools/listComponents.ts';\n\n/**\n * Create and configure the MCP server\n */\nexport function createServer(): McpServer {\n // Create an MCP server\n const server = new McpServer({\n name: 'brick-design-system',\n version: '1.0.0',\n });\n\n // Register list-components tool\n server.registerTool(\n 'list-components',\n {\n title: 'List Brick Components',\n description:\n 'List all available Brick components with metadata. Optionally filter by category, tag, or name.',\n inputSchema: z.object({\n filter: z\n .string()\n .optional()\n .describe('Optional filter by category, tag, or name'),\n }),\n } as const,\n async ({ filter }: { filter?: string }) => {\n const result = await listComponents({ filter });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-component-docs tool\n server.registerTool(\n 'get-component-docs',\n {\n title: 'Get Component Documentation',\n description:\n 'Retrieve detailed documentation for specific Brick component(s) including props, events, examples, and accessibility information.',\n inputSchema: z.object({\n components: z\n .array(z.string())\n .describe(\n 'Array of component names (e.g., [\"brick-button\", \"brick-modal\"])'\n ),\n }),\n } as const,\n async ({ components }: { components: string[] }) => {\n const result = await getComponentDocs({ components });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-design-tokens tool\n server.registerTool(\n 'get-design-tokens',\n {\n title: 'Get Design Tokens',\n description:\n 'Access design tokens from brick-tokens. Optionally filter by category (colors, spacing, typography, shadows, borders).',\n inputSchema: z.object({\n category: z\n .enum(['colors', 'spacing', 'typography', 'shadows', 'borders'])\n .optional()\n .describe('Filter tokens by category'),\n }),\n } as const,\n async ({\n category,\n }: {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n }) => {\n const result = await getDesignTokens({ category });\n\n return {\n content: [\n {\n type: 'text',\n text: result,\n },\n ],\n };\n }\n );\n\n return server;\n}\n", "/**\n * Get Component Docs tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { loadComponentData } from '../extractors/packageScanner.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface GetComponentDocsInput {\n components: string[]; // e.g., [\"brick-button\", \"brick-modal\"]\n}\n\nexport interface GetComponentDocsOutput {\n docs: string[];\n}\n\n/**\n * Load markdown documentation for a component\n */\nasync function loadComponentMarkdown(\n componentName: string\n): Promise<string | undefined> {\n try {\n const markdownPath = join(\n getDataPath(),\n 'components',\n `${componentName}.md`\n );\n const content = await readFile(markdownPath, 'utf-8');\n return content;\n } catch (error) {\n console.error(`Error loading markdown for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Get detailed documentation for specific component(s)\n */\nexport async function getComponentDocs(\n input: GetComponentDocsInput\n): Promise<GetComponentDocsOutput> {\n // Load markdown documentation for each requested component\n const docsPromises = input.components.map(async (componentName) => {\n const md = await loadComponentMarkdown(componentName);\n if (!md) {\n const json = await loadComponentData(componentName);\n return json ? JSON.stringify(json) : undefined;\n }\n return md;\n });\n\n const docsResults = await Promise.all(docsPromises);\n\n // Filter out any components that failed to load\n const docs = docsResults.filter((doc): doc is string => doc !== undefined);\n\n return { docs };\n}\n", "/**\n * Package scanner for discovering Brick components\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { type BrickComponent, type BrickComponentMetadata } from '../types.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\n/**\n * Load all component metadata (lightweight, for listing)\n */\nexport async function scanAllPackages(): Promise<BrickComponentMetadata[]> {\n try {\n const metadataPath = join(getDataPath(), 'components-metadata.json');\n const content = await readFile(metadataPath, 'utf-8');\n const metadata: BrickComponentMetadata[] = JSON.parse(content);\n return metadata;\n } catch (error) {\n console.error('Error loading component metadata:', error);\n return [];\n }\n}\n\n/**\n * Load full component data for a specific component\n */\nexport async function loadComponentData(\n componentName: string\n): Promise<BrickComponent | undefined> {\n try {\n const componentPath = join(\n getDataPath(),\n 'components',\n `${componentName}.json`\n );\n const content = await readFile(componentPath, 'utf-8');\n const component: BrickComponent = JSON.parse(content);\n return component;\n } catch (error) {\n console.error(`Error loading component data for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Filter components by category or tag\n */\nexport function filterComponents(\n components: BrickComponentMetadata[],\n filter?: string\n): BrickComponentMetadata[] {\n if (!filter) {\n return components;\n }\n\n const filterLower = filter.toLowerCase();\n\n return components.filter((component) => {\n // Match against name\n if (component.name.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against category\n if (component.category?.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against tags\n if (\n component.tags?.some((tag) => tag.toLowerCase().includes(filterLower))\n ) {\n return true;\n }\n\n return false;\n });\n}\n", "/**\n * Utility for finding the data directory path\n * Works both in development (from src/) and production (from dist/)\n */\n\nimport { accessSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Get the path to the data directory\n * When running from dist/, looks for dist/data\n * When running from src/, looks for package root data\n */\nexport function getDataPath(): string {\n const currentFilePath = fileURLToPath(import.meta.url);\n let dir = dirname(currentFilePath);\n\n // First check if there's a data directory in the same parent as the current file\n // This handles the dist/data case when running from dist/\n const localDataPath = join(dir, 'data');\n try {\n accessSync(localDataPath);\n return localDataPath;\n } catch {\n // Continue to package root search\n }\n\n // Walk up the directory tree to find package root (where package.json exists)\n for (let i = 0; i < 5; i++) {\n try {\n const testPath = join(dir, 'package.json');\n accessSync(testPath);\n return join(dir, 'data');\n } catch {\n // Go up one level\n const parent = dirname(dir);\n if (parent === dir) break; // Reached filesystem root\n dir = parent;\n }\n }\n\n return join(dirname(currentFilePath), '..', '..', 'data');\n}\n", "/**\n * Get Design Tokens tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface DesignToken {\n path: string;\n name: string;\n type: string;\n value: string;\n description?: string;\n cssVariable: string;\n}\n\nexport interface GetDesignTokensInput {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n}\n\n/**\n * Category filter definitions mapping category names to path prefixes\n */\nconst CATEGORY_PREFIXES: Record<string, string[]> = {\n colors: ['color.'],\n spacing: ['spacing.'],\n typography: ['typography.'],\n shadows: ['box-shadow.'],\n borders: ['border-width.', 'border-radius.', 'border.'],\n};\n\n/**\n * Get the path to the bundled tokens data\n */\nfunction getTokensDataPath(): string {\n return join(getDataPath(), 'tokens.json');\n}\n\n/**\n * Load all tokens from bundled JSON data\n */\nasync function loadAllTokens(): Promise<DesignToken[]> {\n try {\n const dataPath = getTokensDataPath();\n const content = await readFile(dataPath, 'utf-8');\n return JSON.parse(content);\n } catch (error) {\n console.error('Error loading tokens data:', error);\n return [];\n }\n}\n\n/**\n * Check if a token belongs to a given category\n */\nfunction tokenMatchesCategory(token: DesignToken, category: string): boolean {\n const prefixes = CATEGORY_PREFIXES[category];\n if (!prefixes) return false;\n const path = token.path.toLowerCase();\n return prefixes.some((prefix) => path.startsWith(prefix));\n}\n\n/**\n * Format tokens as a compact text listing\n */\nfunction formatTokensCompact(tokens: DesignToken[]): string {\n return tokens\n .map((t) => {\n const base = `${t.cssVariable}: ${t.value}`;\n return t.description ? `${base} \u2014 ${t.description}` : base;\n })\n .join('\\n');\n}\n\n/**\n * Build a category summary with counts and example token paths\n */\nfunction buildCategorySummary(allTokens: DesignToken[]): string {\n const lines: string[] = ['Available token categories:'];\n\n for (const category of Object.keys(CATEGORY_PREFIXES)) {\n const matching = allTokens.filter((t) => tokenMatchesCategory(t, category));\n const count = matching.length;\n const examples = matching\n .slice(0, 3)\n .map((t) => t.path)\n .join(', ');\n const suffix = examples ? ` (${examples}, ...)` : '';\n lines.push(`- ${category}: ${count} tokens${suffix}`);\n }\n\n lines.push('', 'Call with a specific category to see tokens.');\n return lines.join('\\n');\n}\n\n/**\n * Get design tokens with optional filtering.\n * Returns a compact text string to minimize context window usage.\n */\nexport async function getDesignTokens(\n input: GetDesignTokensInput\n): Promise<string> {\n const allTokens = await loadAllTokens();\n\n // No category: return summary instead of dumping all tokens\n if (!input.category) {\n return buildCategorySummary(allTokens);\n }\n\n const filteredTokens = allTokens.filter((t) =>\n tokenMatchesCategory(t, input.category!)\n );\n\n const header = `${input.category} tokens (${filteredTokens.length} tokens). Values shown are examples from one theme. Actual values vary across themes (alfa, bravo, charlie, nettavisen, alt). Use the CSS variable for theme-aware styling.\\n`;\n return header + formatTokensCompact(filteredTokens);\n}\n", "/**\n * List Components tool implementation\n */\n\nimport {\n filterComponents,\n scanAllPackages,\n} from '../extractors/packageScanner.ts';\nimport type { BrickComponentMetadata } from '../types.ts';\n\nexport interface ListComponentsInput {\n filter?: string;\n}\n\nexport interface ListComponentsOutput {\n components: BrickComponentMetadata[];\n}\n\n/**\n * List all available Brick components with optional filtering\n */\nexport async function listComponents(\n input: ListComponentsInput\n): Promise<ListComponentsOutput> {\n // Scan all packages in the monorepo (returns lightweight metadata)\n const allComponents = await scanAllPackages();\n\n // Apply filter if provided\n const components = filterComponents(allComponents, input.filter);\n\n return {\n components,\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["readFile", "join", "join", "join", "join", "readFile", "readFile", "join", "join", "readFile"]
|
|
7
7
|
}
|
package/dist/index.js
CHANGED
|
@@ -10,6 +10,10 @@ import { z } from "zod";
|
|
|
10
10
|
import { readFile as readFile2 } from "node:fs/promises";
|
|
11
11
|
import { join as join3 } from "node:path";
|
|
12
12
|
|
|
13
|
+
// src/extractors/packageScanner.ts
|
|
14
|
+
import { readFile } from "node:fs/promises";
|
|
15
|
+
import { join as join2 } from "node:path";
|
|
16
|
+
|
|
13
17
|
// src/utils/dataPath.ts
|
|
14
18
|
import { accessSync } from "node:fs";
|
|
15
19
|
import { dirname, join } from "node:path";
|
|
@@ -38,8 +42,6 @@ function getDataPath() {
|
|
|
38
42
|
}
|
|
39
43
|
|
|
40
44
|
// src/extractors/packageScanner.ts
|
|
41
|
-
import { readFile } from "node:fs/promises";
|
|
42
|
-
import { join as join2 } from "node:path";
|
|
43
45
|
async function scanAllPackages() {
|
|
44
46
|
try {
|
|
45
47
|
const metadataPath = join2(getDataPath(), "components-metadata.json");
|
package/dist/index.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../src/index.ts", "../src/server.ts", "../src/tools/getComponentDocs.ts", "../src/
|
|
4
|
-
"sourcesContent": ["/**\n * Main MCP server entry point\n */\n\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createServer } from './server.ts';\n\n// Create and start the server\nconst server = createServer();\n\n// Start receiving messages on stdin and sending messages on stdout\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n", "/**\n * MCP server setup and registration\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { getComponentDocs } from './tools/getComponentDocs.ts';\nimport { getDesignTokens } from './tools/getDesignTokens.ts';\nimport { listComponents } from './tools/listComponents.ts';\n\n/**\n * Create and configure the MCP server\n */\nexport function createServer(): McpServer {\n // Create an MCP server\n const server = new McpServer({\n name: 'brick-design-system',\n version: '1.0.0',\n });\n\n // Register list-components tool\n server.registerTool(\n 'list-components',\n {\n title: 'List Brick Components',\n description:\n 'List all available Brick components with metadata. Optionally filter by category, tag, or name.',\n inputSchema: z.object({\n filter: z\n .string()\n .optional()\n .describe('Optional filter by category, tag, or name'),\n }),\n } as const,\n async ({ filter }: { filter?: string }) => {\n const result = await listComponents({ filter });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-component-docs tool\n server.registerTool(\n 'get-component-docs',\n {\n title: 'Get Component Documentation',\n description:\n 'Retrieve detailed documentation for specific Brick component(s) including props, events, examples, and accessibility information.',\n inputSchema: z.object({\n components: z\n .array(z.string())\n .describe(\n 'Array of component names (e.g., [\"brick-button\", \"brick-modal\"])'\n ),\n }),\n } as const,\n async ({ components }: { components: string[] }) => {\n const result = await getComponentDocs({ components });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-design-tokens tool\n server.registerTool(\n 'get-design-tokens',\n {\n title: 'Get Design Tokens',\n description:\n 'Access design tokens from brick-tokens. Optionally filter by category (colors, spacing, typography, shadows, borders).',\n inputSchema: z.object({\n category: z\n .enum(['colors', 'spacing', 'typography', 'shadows', 'borders'])\n .optional()\n .describe('Filter tokens by category'),\n }),\n } as const,\n async ({\n category,\n }: {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n }) => {\n const result = await getDesignTokens({ category });\n\n return {\n content: [\n {\n type: 'text',\n text: result,\n },\n ],\n };\n }\n );\n\n return server;\n}\n", "/**\n * Get Component Docs tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\nimport { loadComponentData } from '../extractors/packageScanner.ts';\n\nexport interface GetComponentDocsInput {\n components: string[]; // e.g., [\"brick-button\", \"brick-modal\"]\n}\n\nexport interface GetComponentDocsOutput {\n docs: string[];\n}\n\n/**\n * Load markdown documentation for a component\n */\nasync function loadComponentMarkdown(\n componentName: string\n): Promise<string | undefined> {\n try {\n const markdownPath = join(\n getDataPath(),\n 'components',\n `${componentName}.md`\n );\n const content = await readFile(markdownPath, 'utf-8');\n return content;\n } catch (error) {\n console.error(`Error loading markdown for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Get detailed documentation for specific component(s)\n */\nexport async function getComponentDocs(\n input: GetComponentDocsInput\n): Promise<GetComponentDocsOutput> {\n // Load markdown documentation for each requested component\n const docsPromises = input.components.map(async (componentName) => {\n const md = await loadComponentMarkdown(componentName);\n if (!md) {\n const json = await loadComponentData(componentName);\n return json ? JSON.stringify(json) : undefined;\n }\n return md;\n });\n\n const docsResults = await Promise.all(docsPromises);\n\n // Filter out any components that failed to load\n const docs = docsResults.filter((doc): doc is string => doc !== undefined);\n\n return { docs };\n}\n", "/**\n * Utility for finding the data directory path\n * Works both in development (from src/) and production (from dist/)\n */\n\nimport { accessSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Get the path to the data directory\n * When running from dist/, looks for dist/data\n * When running from src/, looks for package root data\n */\nexport function getDataPath(): string {\n const currentFilePath = fileURLToPath(import.meta.url);\n let dir = dirname(currentFilePath);\n\n // First check if there's a data directory in the same parent as the current file\n // This handles the dist/data case when running from dist/\n const localDataPath = join(dir, 'data');\n try {\n accessSync(localDataPath);\n return localDataPath;\n } catch {\n // Continue to package root search\n }\n\n // Walk up the directory tree to find package root (where package.json exists)\n for (let i = 0; i < 5; i++) {\n try {\n const testPath = join(dir, 'package.json');\n accessSync(testPath);\n return join(dir, 'data');\n } catch {\n // Go up one level\n const parent = dirname(dir);\n if (parent === dir) break; // Reached filesystem root\n dir = parent;\n }\n }\n\n return join(dirname(currentFilePath), '..', '..', 'data');\n}\n", "/**\n * Package scanner for discovering Brick components\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { type BrickComponent, type BrickComponentMetadata } from '../types.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\n/**\n * Load all component metadata (lightweight, for listing)\n */\nexport async function scanAllPackages(): Promise<BrickComponentMetadata[]> {\n try {\n const metadataPath = join(getDataPath(), 'components-metadata.json');\n const content = await readFile(metadataPath, 'utf-8');\n const metadata: BrickComponentMetadata[] = JSON.parse(content);\n return metadata;\n } catch (error) {\n console.error('Error loading component metadata:', error);\n return [];\n }\n}\n\n/**\n * Load full component data for a specific component\n */\nexport async function loadComponentData(\n componentName: string\n): Promise<BrickComponent | undefined> {\n try {\n const componentPath = join(\n getDataPath(),\n 'components',\n `${componentName}.json`\n );\n const content = await readFile(componentPath, 'utf-8');\n const component: BrickComponent = JSON.parse(content);\n return component;\n } catch (error) {\n console.error(`Error loading component data for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Filter components by category or tag\n */\nexport function filterComponents(\n components: BrickComponentMetadata[],\n filter?: string\n): BrickComponentMetadata[] {\n if (!filter) {\n return components;\n }\n\n const filterLower = filter.toLowerCase();\n\n return components.filter((component) => {\n // Match against name\n if (component.name.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against category\n if (component.category?.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against tags\n if (\n component.tags?.some((tag) => tag.toLowerCase().includes(filterLower))\n ) {\n return true;\n }\n\n return false;\n });\n}\n", "/**\n * Get Design Tokens tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface DesignToken {\n path: string;\n name: string;\n type: string;\n value: string;\n description?: string;\n cssVariable: string;\n}\n\nexport interface GetDesignTokensInput {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n}\n\n/**\n * Category filter definitions mapping category names to path prefixes\n */\nconst CATEGORY_PREFIXES: Record<string, string[]> = {\n colors: ['color.'],\n spacing: ['spacing.'],\n typography: ['typography.'],\n shadows: ['box-shadow.'],\n borders: ['border-width.', 'border-radius.', 'border.'],\n};\n\n/**\n * Get the path to the bundled tokens data\n */\nfunction getTokensDataPath(): string {\n return join(getDataPath(), 'tokens.json');\n}\n\n/**\n * Load all tokens from bundled JSON data\n */\nasync function loadAllTokens(): Promise<DesignToken[]> {\n try {\n const dataPath = getTokensDataPath();\n const content = await readFile(dataPath, 'utf-8');\n return JSON.parse(content);\n } catch (error) {\n console.error('Error loading tokens data:', error);\n return [];\n }\n}\n\n/**\n * Check if a token belongs to a given category\n */\nfunction tokenMatchesCategory(token: DesignToken, category: string): boolean {\n const prefixes = CATEGORY_PREFIXES[category];\n if (!prefixes) return false;\n const path = token.path.toLowerCase();\n return prefixes.some((prefix) => path.startsWith(prefix));\n}\n\n/**\n * Format tokens as a compact text listing\n */\nfunction formatTokensCompact(tokens: DesignToken[]): string {\n return tokens\n .map((t) => {\n const base = `${t.cssVariable}: ${t.value}`;\n return t.description ? `${base} \u2014 ${t.description}` : base;\n })\n .join('\\n');\n}\n\n/**\n * Build a category summary with counts and example token paths\n */\nfunction buildCategorySummary(allTokens: DesignToken[]): string {\n const lines: string[] = ['Available token categories:'];\n\n for (const category of Object.keys(CATEGORY_PREFIXES)) {\n const matching = allTokens.filter((t) => tokenMatchesCategory(t, category));\n const count = matching.length;\n const examples = matching\n .slice(0, 3)\n .map((t) => t.path)\n .join(', ');\n const suffix = examples ? ` (${examples}, ...)` : '';\n lines.push(`- ${category}: ${count} tokens${suffix}`);\n }\n\n lines.push('', 'Call with a specific category to see tokens.');\n return lines.join('\\n');\n}\n\n/**\n * Get design tokens with optional filtering.\n * Returns a compact text string to minimize context window usage.\n */\nexport async function getDesignTokens(\n input: GetDesignTokensInput\n): Promise<string> {\n const allTokens = await loadAllTokens();\n\n // No category: return summary instead of dumping all tokens\n if (!input.category) {\n return buildCategorySummary(allTokens);\n }\n\n const filteredTokens = allTokens.filter((t) =>\n tokenMatchesCategory(t, input.category!)\n );\n\n const header = `${input.category} tokens (${filteredTokens.length} tokens). Values shown are examples from one theme. Actual values vary across themes (alfa, bravo, charlie, nettavisen, alt). Use the CSS variable for theme-aware styling.\\n`;\n return header + formatTokensCompact(filteredTokens);\n}\n", "/**\n * List Components tool implementation\n */\n\nimport {\n filterComponents,\n scanAllPackages,\n} from '../extractors/packageScanner.ts';\nimport type { BrickComponentMetadata } from '../types.ts';\n\nexport interface ListComponentsInput {\n filter?: string;\n}\n\nexport interface ListComponentsOutput {\n components: BrickComponentMetadata[];\n}\n\n/**\n * List all available Brick components with optional filtering\n */\nexport async function listComponents(\n input: ListComponentsInput\n): Promise<ListComponentsOutput> {\n // Scan all packages in the monorepo (returns lightweight metadata)\n const allComponents = await scanAllPackages();\n\n // Apply filter if provided\n const components = filterComponents(allComponents, input.filter);\n\n return {\n components,\n };\n}\n"],
|
|
5
|
-
"mappings": ";AAIA,SAAS,4BAA4B;;;ACArC,SAAS,iBAAiB;AAC1B,SAAS,SAAS;;;ACDlB,SAAS,YAAAA,iBAAgB;AACzB,SAAS,QAAAC,aAAY;;;ACArB,SAAS,kBAAkB;AAC3B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAOvB,SAAS,cAAsB;AACpC,QAAM,kBAAkB,cAAc,YAAY,GAAG;AACrD,MAAI,MAAM,QAAQ,eAAe;AAIjC,QAAM,gBAAgB,KAAK,KAAK,MAAM;AACtC,MAAI;AACF,eAAW,aAAa;AACxB,WAAO;AAAA,EACT,QAAQ;AAAA,EAER;AAGA,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAI;AACF,YAAM,WAAW,KAAK,KAAK,cAAc;AACzC,iBAAW,QAAQ;AACnB,aAAO,KAAK,KAAK,MAAM;AAAA,IACzB,QAAQ;AAEN,YAAM,SAAS,QAAQ,GAAG;AAC1B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AAAA,EACF;AAEA,SAAO,KAAK,QAAQ,eAAe,GAAG,MAAM,MAAM,MAAM;AAC1D;;;
|
|
3
|
+
"sources": ["../src/index.ts", "../src/server.ts", "../src/tools/getComponentDocs.ts", "../src/extractors/packageScanner.ts", "../src/utils/dataPath.ts", "../src/tools/getDesignTokens.ts", "../src/tools/listComponents.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * Main MCP server entry point\n */\n\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { createServer } from './server.ts';\n\n// Create and start the server\nconst server = createServer();\n\n// Start receiving messages on stdin and sending messages on stdout\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n", "/**\n * MCP server setup and registration\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\nimport { getComponentDocs } from './tools/getComponentDocs.ts';\nimport { getDesignTokens } from './tools/getDesignTokens.ts';\nimport { listComponents } from './tools/listComponents.ts';\n\n/**\n * Create and configure the MCP server\n */\nexport function createServer(): McpServer {\n // Create an MCP server\n const server = new McpServer({\n name: 'brick-design-system',\n version: '1.0.0',\n });\n\n // Register list-components tool\n server.registerTool(\n 'list-components',\n {\n title: 'List Brick Components',\n description:\n 'List all available Brick components with metadata. Optionally filter by category, tag, or name.',\n inputSchema: z.object({\n filter: z\n .string()\n .optional()\n .describe('Optional filter by category, tag, or name'),\n }),\n } as const,\n async ({ filter }: { filter?: string }) => {\n const result = await listComponents({ filter });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-component-docs tool\n server.registerTool(\n 'get-component-docs',\n {\n title: 'Get Component Documentation',\n description:\n 'Retrieve detailed documentation for specific Brick component(s) including props, events, examples, and accessibility information.',\n inputSchema: z.object({\n components: z\n .array(z.string())\n .describe(\n 'Array of component names (e.g., [\"brick-button\", \"brick-modal\"])'\n ),\n }),\n } as const,\n async ({ components }: { components: string[] }) => {\n const result = await getComponentDocs({ components });\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n }\n );\n\n // Register get-design-tokens tool\n server.registerTool(\n 'get-design-tokens',\n {\n title: 'Get Design Tokens',\n description:\n 'Access design tokens from brick-tokens. Optionally filter by category (colors, spacing, typography, shadows, borders).',\n inputSchema: z.object({\n category: z\n .enum(['colors', 'spacing', 'typography', 'shadows', 'borders'])\n .optional()\n .describe('Filter tokens by category'),\n }),\n } as const,\n async ({\n category,\n }: {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n }) => {\n const result = await getDesignTokens({ category });\n\n return {\n content: [\n {\n type: 'text',\n text: result,\n },\n ],\n };\n }\n );\n\n return server;\n}\n", "/**\n * Get Component Docs tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { loadComponentData } from '../extractors/packageScanner.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface GetComponentDocsInput {\n components: string[]; // e.g., [\"brick-button\", \"brick-modal\"]\n}\n\nexport interface GetComponentDocsOutput {\n docs: string[];\n}\n\n/**\n * Load markdown documentation for a component\n */\nasync function loadComponentMarkdown(\n componentName: string\n): Promise<string | undefined> {\n try {\n const markdownPath = join(\n getDataPath(),\n 'components',\n `${componentName}.md`\n );\n const content = await readFile(markdownPath, 'utf-8');\n return content;\n } catch (error) {\n console.error(`Error loading markdown for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Get detailed documentation for specific component(s)\n */\nexport async function getComponentDocs(\n input: GetComponentDocsInput\n): Promise<GetComponentDocsOutput> {\n // Load markdown documentation for each requested component\n const docsPromises = input.components.map(async (componentName) => {\n const md = await loadComponentMarkdown(componentName);\n if (!md) {\n const json = await loadComponentData(componentName);\n return json ? JSON.stringify(json) : undefined;\n }\n return md;\n });\n\n const docsResults = await Promise.all(docsPromises);\n\n // Filter out any components that failed to load\n const docs = docsResults.filter((doc): doc is string => doc !== undefined);\n\n return { docs };\n}\n", "/**\n * Package scanner for discovering Brick components\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { type BrickComponent, type BrickComponentMetadata } from '../types.ts';\nimport { getDataPath } from '../utils/dataPath.ts';\n\n/**\n * Load all component metadata (lightweight, for listing)\n */\nexport async function scanAllPackages(): Promise<BrickComponentMetadata[]> {\n try {\n const metadataPath = join(getDataPath(), 'components-metadata.json');\n const content = await readFile(metadataPath, 'utf-8');\n const metadata: BrickComponentMetadata[] = JSON.parse(content);\n return metadata;\n } catch (error) {\n console.error('Error loading component metadata:', error);\n return [];\n }\n}\n\n/**\n * Load full component data for a specific component\n */\nexport async function loadComponentData(\n componentName: string\n): Promise<BrickComponent | undefined> {\n try {\n const componentPath = join(\n getDataPath(),\n 'components',\n `${componentName}.json`\n );\n const content = await readFile(componentPath, 'utf-8');\n const component: BrickComponent = JSON.parse(content);\n return component;\n } catch (error) {\n console.error(`Error loading component data for ${componentName}:`, error);\n return undefined;\n }\n}\n\n/**\n * Filter components by category or tag\n */\nexport function filterComponents(\n components: BrickComponentMetadata[],\n filter?: string\n): BrickComponentMetadata[] {\n if (!filter) {\n return components;\n }\n\n const filterLower = filter.toLowerCase();\n\n return components.filter((component) => {\n // Match against name\n if (component.name.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against category\n if (component.category?.toLowerCase().includes(filterLower)) {\n return true;\n }\n\n // Match against tags\n if (\n component.tags?.some((tag) => tag.toLowerCase().includes(filterLower))\n ) {\n return true;\n }\n\n return false;\n });\n}\n", "/**\n * Utility for finding the data directory path\n * Works both in development (from src/) and production (from dist/)\n */\n\nimport { accessSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Get the path to the data directory\n * When running from dist/, looks for dist/data\n * When running from src/, looks for package root data\n */\nexport function getDataPath(): string {\n const currentFilePath = fileURLToPath(import.meta.url);\n let dir = dirname(currentFilePath);\n\n // First check if there's a data directory in the same parent as the current file\n // This handles the dist/data case when running from dist/\n const localDataPath = join(dir, 'data');\n try {\n accessSync(localDataPath);\n return localDataPath;\n } catch {\n // Continue to package root search\n }\n\n // Walk up the directory tree to find package root (where package.json exists)\n for (let i = 0; i < 5; i++) {\n try {\n const testPath = join(dir, 'package.json');\n accessSync(testPath);\n return join(dir, 'data');\n } catch {\n // Go up one level\n const parent = dirname(dir);\n if (parent === dir) break; // Reached filesystem root\n dir = parent;\n }\n }\n\n return join(dirname(currentFilePath), '..', '..', 'data');\n}\n", "/**\n * Get Design Tokens tool implementation\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { getDataPath } from '../utils/dataPath.ts';\n\nexport interface DesignToken {\n path: string;\n name: string;\n type: string;\n value: string;\n description?: string;\n cssVariable: string;\n}\n\nexport interface GetDesignTokensInput {\n category?: 'colors' | 'spacing' | 'typography' | 'shadows' | 'borders';\n}\n\n/**\n * Category filter definitions mapping category names to path prefixes\n */\nconst CATEGORY_PREFIXES: Record<string, string[]> = {\n colors: ['color.'],\n spacing: ['spacing.'],\n typography: ['typography.'],\n shadows: ['box-shadow.'],\n borders: ['border-width.', 'border-radius.', 'border.'],\n};\n\n/**\n * Get the path to the bundled tokens data\n */\nfunction getTokensDataPath(): string {\n return join(getDataPath(), 'tokens.json');\n}\n\n/**\n * Load all tokens from bundled JSON data\n */\nasync function loadAllTokens(): Promise<DesignToken[]> {\n try {\n const dataPath = getTokensDataPath();\n const content = await readFile(dataPath, 'utf-8');\n return JSON.parse(content);\n } catch (error) {\n console.error('Error loading tokens data:', error);\n return [];\n }\n}\n\n/**\n * Check if a token belongs to a given category\n */\nfunction tokenMatchesCategory(token: DesignToken, category: string): boolean {\n const prefixes = CATEGORY_PREFIXES[category];\n if (!prefixes) return false;\n const path = token.path.toLowerCase();\n return prefixes.some((prefix) => path.startsWith(prefix));\n}\n\n/**\n * Format tokens as a compact text listing\n */\nfunction formatTokensCompact(tokens: DesignToken[]): string {\n return tokens\n .map((t) => {\n const base = `${t.cssVariable}: ${t.value}`;\n return t.description ? `${base} \u2014 ${t.description}` : base;\n })\n .join('\\n');\n}\n\n/**\n * Build a category summary with counts and example token paths\n */\nfunction buildCategorySummary(allTokens: DesignToken[]): string {\n const lines: string[] = ['Available token categories:'];\n\n for (const category of Object.keys(CATEGORY_PREFIXES)) {\n const matching = allTokens.filter((t) => tokenMatchesCategory(t, category));\n const count = matching.length;\n const examples = matching\n .slice(0, 3)\n .map((t) => t.path)\n .join(', ');\n const suffix = examples ? ` (${examples}, ...)` : '';\n lines.push(`- ${category}: ${count} tokens${suffix}`);\n }\n\n lines.push('', 'Call with a specific category to see tokens.');\n return lines.join('\\n');\n}\n\n/**\n * Get design tokens with optional filtering.\n * Returns a compact text string to minimize context window usage.\n */\nexport async function getDesignTokens(\n input: GetDesignTokensInput\n): Promise<string> {\n const allTokens = await loadAllTokens();\n\n // No category: return summary instead of dumping all tokens\n if (!input.category) {\n return buildCategorySummary(allTokens);\n }\n\n const filteredTokens = allTokens.filter((t) =>\n tokenMatchesCategory(t, input.category!)\n );\n\n const header = `${input.category} tokens (${filteredTokens.length} tokens). Values shown are examples from one theme. Actual values vary across themes (alfa, bravo, charlie, nettavisen, alt). Use the CSS variable for theme-aware styling.\\n`;\n return header + formatTokensCompact(filteredTokens);\n}\n", "/**\n * List Components tool implementation\n */\n\nimport {\n filterComponents,\n scanAllPackages,\n} from '../extractors/packageScanner.ts';\nimport type { BrickComponentMetadata } from '../types.ts';\n\nexport interface ListComponentsInput {\n filter?: string;\n}\n\nexport interface ListComponentsOutput {\n components: BrickComponentMetadata[];\n}\n\n/**\n * List all available Brick components with optional filtering\n */\nexport async function listComponents(\n input: ListComponentsInput\n): Promise<ListComponentsOutput> {\n // Scan all packages in the monorepo (returns lightweight metadata)\n const allComponents = await scanAllPackages();\n\n // Apply filter if provided\n const components = filterComponents(allComponents, input.filter);\n\n return {\n components,\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["readFile", "join", "join", "join", "join", "readFile", "readFile", "join", "join", "readFile", "server"]
|
|
7
7
|
}
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@amedia/brick-mcp",
|
|
3
3
|
"homepage": "https://github.com/amedia/brick.git",
|
|
4
4
|
"author": "Amedia",
|
|
5
|
-
"version": "1.0.
|
|
5
|
+
"version": "1.0.5",
|
|
6
6
|
"description": "This is a MCP server for Brick",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"type": "module",
|
|
@@ -35,46 +35,46 @@
|
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@fastify/cors": "11.1.0",
|
|
37
37
|
"@modelcontextprotocol/sdk": "1.27.1",
|
|
38
|
-
"fastify": "5.8.
|
|
38
|
+
"fastify": "5.8.5",
|
|
39
39
|
"zod": "3.25.76",
|
|
40
40
|
"zod-to-json-schema": "3.24.6"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
43
|
-
"@amedia/brick-alt-teaser": "8.1.
|
|
44
|
-
"@amedia/brick-avatar": "0.2.
|
|
45
|
-
"@amedia/brick-button": "9.4.
|
|
46
|
-
"@amedia/brick-byline": "
|
|
47
|
-
"@amedia/brick-card": "7.3.
|
|
48
|
-
"@amedia/brick-carousel": "2.3.
|
|
43
|
+
"@amedia/brick-alt-teaser": "8.1.27",
|
|
44
|
+
"@amedia/brick-avatar": "0.2.64",
|
|
45
|
+
"@amedia/brick-button": "9.4.22",
|
|
46
|
+
"@amedia/brick-byline": "2.0.1",
|
|
47
|
+
"@amedia/brick-card": "7.3.36",
|
|
48
|
+
"@amedia/brick-carousel": "2.3.9",
|
|
49
49
|
"@amedia/brick-classnames": "3.0.3",
|
|
50
|
-
"@amedia/brick-countdown": "3.0.
|
|
51
|
-
"@amedia/brick-dialog": "2.1.
|
|
52
|
-
"@amedia/brick-expand": "0.0.
|
|
50
|
+
"@amedia/brick-countdown": "3.0.11",
|
|
51
|
+
"@amedia/brick-dialog": "2.1.19",
|
|
52
|
+
"@amedia/brick-expand": "0.0.31",
|
|
53
53
|
"@amedia/brick-fonts": "2.0.3",
|
|
54
|
-
"@amedia/brick-helloworld": "2.
|
|
55
|
-
"@amedia/brick-icon": "2.4.
|
|
56
|
-
"@amedia/brick-icons": "2.2.
|
|
54
|
+
"@amedia/brick-helloworld": "2.1.2",
|
|
55
|
+
"@amedia/brick-icon": "2.4.3",
|
|
56
|
+
"@amedia/brick-icons": "2.2.7",
|
|
57
57
|
"@amedia/brick-illustrations": "1.3.1",
|
|
58
|
-
"@amedia/brick-image": "6.0.
|
|
59
|
-
"@amedia/brick-input": "4.0.
|
|
60
|
-
"@amedia/brick-pill": "10.1.
|
|
61
|
-
"@amedia/brick-player": "2.4.
|
|
62
|
-
"@amedia/brick-published": "4.0.
|
|
63
|
-
"@amedia/brick-share": "0.4.
|
|
64
|
-
"@amedia/brick-stepper": "1.1.
|
|
65
|
-
"@amedia/brick-tab": "0.1.
|
|
66
|
-
"@amedia/brick-tabs": "0.1.
|
|
67
|
-
"@amedia/brick-tag": "0.0.
|
|
68
|
-
"@amedia/brick-teaser": "22.2.
|
|
69
|
-
"@amedia/brick-teaser-player": "1.1.
|
|
70
|
-
"@amedia/brick-teaser-reels": "0.4.
|
|
71
|
-
"@amedia/brick-template": "2.0
|
|
72
|
-
"@amedia/brick-textarea": "2.0.
|
|
58
|
+
"@amedia/brick-image": "6.0.31",
|
|
59
|
+
"@amedia/brick-input": "4.0.11",
|
|
60
|
+
"@amedia/brick-pill": "10.1.10",
|
|
61
|
+
"@amedia/brick-player": "2.4.7",
|
|
62
|
+
"@amedia/brick-published": "4.0.27",
|
|
63
|
+
"@amedia/brick-share": "0.4.7",
|
|
64
|
+
"@amedia/brick-stepper": "1.1.13",
|
|
65
|
+
"@amedia/brick-tab": "0.1.34",
|
|
66
|
+
"@amedia/brick-tabs": "0.1.35",
|
|
67
|
+
"@amedia/brick-tag": "0.0.34",
|
|
68
|
+
"@amedia/brick-teaser": "22.2.13",
|
|
69
|
+
"@amedia/brick-teaser-player": "1.1.24",
|
|
70
|
+
"@amedia/brick-teaser-reels": "0.4.26",
|
|
71
|
+
"@amedia/brick-template": "2.1.0",
|
|
72
|
+
"@amedia/brick-textarea": "2.0.30",
|
|
73
73
|
"@amedia/brick-themes": "1.0.3",
|
|
74
|
-
"@amedia/brick-toast": "0.1.
|
|
75
|
-
"@amedia/brick-toggle": "3.1.
|
|
76
|
-
"@amedia/brick-tokens": "6.
|
|
77
|
-
"@amedia/brick-tooltip": "1.0.
|
|
74
|
+
"@amedia/brick-toast": "0.1.48",
|
|
75
|
+
"@amedia/brick-toggle": "3.1.36",
|
|
76
|
+
"@amedia/brick-tokens": "6.3.0",
|
|
77
|
+
"@amedia/brick-tooltip": "1.0.37"
|
|
78
78
|
},
|
|
79
79
|
"eik": {
|
|
80
80
|
"server": "https://assets.acdn.no",
|
|
@@ -83,4 +83,4 @@
|
|
|
83
83
|
"brick-mcp.js.map": "./dist/index.js.map"
|
|
84
84
|
}
|
|
85
85
|
}
|
|
86
|
-
}
|
|
86
|
+
}
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
*/
|
|
8
8
|
|
|
9
9
|
import { readdir, readFile } from 'node:fs/promises';
|
|
10
|
-
import {
|
|
10
|
+
import { dirname, join } from 'node:path';
|
|
11
11
|
import { fileURLToPath } from 'node:url';
|
|
12
12
|
|
|
13
13
|
const __filename = fileURLToPath(import.meta.url);
|
|
@@ -78,7 +78,12 @@ async function main() {
|
|
|
78
78
|
const changeType = compareVersions(docVersion, packageVersion);
|
|
79
79
|
|
|
80
80
|
if (changeType === 'major' || changeType === 'minor') {
|
|
81
|
-
stale.push({
|
|
81
|
+
stale.push({
|
|
82
|
+
name: componentName,
|
|
83
|
+
docVersion,
|
|
84
|
+
packageVersion,
|
|
85
|
+
changeType,
|
|
86
|
+
});
|
|
82
87
|
} else {
|
|
83
88
|
upToDate.push(componentName);
|
|
84
89
|
}
|
|
@@ -101,7 +106,9 @@ async function main() {
|
|
|
101
106
|
console.log(` Checked: ${mdFiles.length} files\n`);
|
|
102
107
|
|
|
103
108
|
if (stale.length > 0) {
|
|
104
|
-
console.warn(
|
|
109
|
+
console.warn(
|
|
110
|
+
`⚠️ Stale MCP docs (${stale.length} component${stale.length > 1 ? 's' : ''}):`
|
|
111
|
+
);
|
|
105
112
|
for (const { name, docVersion, packageVersion, changeType } of stale) {
|
|
106
113
|
console.warn(
|
|
107
114
|
` ${name}: docs ${docVersion} → package ${packageVersion} (${changeType} change)`
|
package/scripts/generate-data.js
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
* This allows the MCP server to work as a standalone package via npx
|
|
4
4
|
*/
|
|
5
5
|
|
|
6
|
-
import { readdir, readFile, writeFile
|
|
7
|
-
import {
|
|
6
|
+
import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
|
|
7
|
+
import { dirname, join } from 'node:path';
|
|
8
8
|
import { fileURLToPath } from 'node:url';
|
|
9
9
|
|
|
10
10
|
const __filename = fileURLToPath(import.meta.url);
|