@expressivecss/mcp-server 0.2.0

package/contract.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": 1,
+  "generatedBy": "scripts/gen-expressivecss-skill.mjs",
+  "frameworkVersion": "0.10.1",
+  "skillVersion": "0.7.0",
+  "matchingTag": "v0.10.1",
+  "releaseTags": [
+    "v0.10.0",
+    "v0.10.1",
+    "v0.5.0",
+    "v0.6.0",
+    "v0.7.0",
+    "v0.7.0-rc.0",
+    "v0.8.0",
+    "v0.9.0",
+    "v0.9.1"
+  ],
+  "sources": [
+    "llm.md",
+    "semantics.json",
+    "docs/src/data/nav.ts",
+    "docs/src/data/component-decisions.json",
+    "package.json",
+    "CHANGELOG.md"
+  ],
+  "sourceHash": "98b9da3400da3b8e16a86e4b52989317a369033dc3b6446441f955d8abfbe09e"
+}

package/lint.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+/**
+ * Command-line front end for the static checks `rules_enforcer` runs: the
+ * bundled semantics rules plus the legacy-pattern and initialization checks.
+ *
+ *   expressivecss-lint <file>...     Report findings; exit 1 when any.
+ *   expressivecss-lint --hook        Read a Claude Code PostToolUse payload on
+ *                                    stdin, lint `tool_input.file_path` when
+ *                                    it is a markup file, exit 2 on findings
+ *                                    so the message goes back to the agent.
+ */
+import { readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { inspectAuthoringRules, readInspectionFile } from './server.js';
+
+// Markdown is left out: a doc concatenates many independent examples, so page-level rules misfire.
+const MARKUP = new Set(['.html', '.htm', '.astro', '.jsx', '.tsx', '.vue', '.svelte']);
+const MAX_BYTES = 2 * 1024 * 1024;
+const problem = (id, rule) => ({ id, severity: 'high', rule, location: { line: 1, column: 1 }, snippet: '' });
+
+/** Findings for one file. A file that cannot be fully inspected is a finding too, never a silent pass. */
+export async function lintFile(file) {
+  let text;
+  try {
+    ({ text } = await readInspectionFile(file, process.cwd(), MAX_BYTES));
+  } catch (error) {
+    return [problem('file-not-inspected', `Skipped: ${error.message}. Files must be regular, inside the working directory, and at most ${MAX_BYTES} bytes.`)];
+  }
+  // ponytail: JSX/Astro/Vue are parsed as HTML after `className` -> `class`; expression-heavy markup can hide from selector rules.
+  const issues = inspectAuthoringRules(text.replace(/\bclassName=/gu, 'class='));
+  if (issues.truncatedReason) issues.push(problem('inspection-truncated', `Static inspection stopped early: ${issues.truncatedReason}. Split the file or reduce its markup.`));
+  return issues;
+}
+
+export function format(file, issues) {
+  return issues
+    .map((issue) => `${file}:${issue.location.line}:${issue.location.column} ${issue.id} [${issue.severity}] ${issue.rule}${issue.snippet ? `\n    ${issue.snippet}` : ''}`)
+    .join('\n');
+}
+
+async function main(argv) {
+  if (argv[0] === '--hook') {
+    const payload = JSON.parse(readFileSync(0, 'utf8') || '{}');
+    const file = payload.tool_input?.file_path;
+    if (!file || !MARKUP.has(path.extname(file).toLowerCase())) return 0;
+    const issues = await lintFile(file);
+    if (!issues.length) return 0;
+    console.error(`ExpressiveCSS lint found ${issues.length} issue(s). Fix them before continuing:\n${format(file, issues)}`);
+    return 2;
+  }
+  if (!argv.length || argv[0] === '--help') {
+    console.error('Usage: expressivecss-lint <file>... | --hook');
+    return argv.length ? 0 : 1;
+  }
+  let total = 0;
+  for (const file of argv) {
+    const issues = await lintFile(file);
+    total += issues.length;
+    if (issues.length) console.log(format(file, issues));
+  }
+  console.error(total ? `${total} issue(s) in ${argv.length} file(s).` : `No issues in ${argv.length} file(s).`);
+  return total ? 1 : 0;
+}
+
+if (process.argv[1] && pathToFileURL(realpathSync(process.argv[1])).href === import.meta.url) {
+  process.exitCode = await main(process.argv.slice(2));
+}

package/mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "expressivecss-mcp": {
+      "command": "npx",
+      "args": ["-y", "@expressivecss/mcp-server@latest"],
+      "env": {
+        "EXPRESSIVECSS_MCP_MAX_COMPONENT_RESPONSE_CHARS": "24000",
+        "EXPRESSIVECSS_MCP_MAX_COMPONENT_SKIPS": "7",
+        "EXPRESSIVECSS_MCP_QA_MAX_FILES": "300",
+        "EXPRESSIVECSS_MCP_QA_MAX_MB": "2"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@expressivecss/mcp-server",
+  "version": "0.2.0",
+  "description": "ExpressiveCSS MCP server with Design→QA workflow tools.",
+  "homepage": "https://www.expressivecss.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BaezFJ/ExpressiveCSS.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "expressivecss-mcp": "server.js",
+    "expressivecss-lint": "lint.mjs"
+  },
+  "main": "server.js",
+  "engines": {
+    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+  },
+  "scripts": {
+    "test": "node smoke.mjs",
+    "prepack": "npm test"
+  },
+  "files": [
+    "server.js",
+    "lint.mjs",
+    "component-guides.json",
+    "component-decisions.json",
+    "capability-roadmap.json",
+    "contract.json",
+    "semantics-data.json",
+    "smoke.mjs",
+    "scripts/resolve-version.mjs",
+    "README.md",
+    "mcp.json",
+    ".claude-plugin/plugin.json",
+    ".cursor-plugin/plugin.json",
+    "sample-hermes-config.yaml",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "jsdom": "^30.1.1",
+    "zod": "^4.6.5"
+  },
+  "overrides": {
+    "qs": "6.16.0"
+  }
+}

package/sample-hermes-config.yaml

@@ -0,0 +1,13 @@
+# Example Hermes MCP wiring for this server.
+# Apply these values with `hermes config set` rather than hand-editing the file.
+
+mcp_servers:
+  expressivecss-mcp:
+    command: node
+    args:
+      - /ABSOLUTE/PATH/TO/REPO/mcp/expressivecss/server.js
+    env:
+      EXPRESSIVECSS_MCP_MAX_COMPONENT_RESPONSE_CHARS: "24000"
+      EXPRESSIVECSS_MCP_MAX_COMPONENT_SKIPS: "7"
+      EXPRESSIVECSS_MCP_QA_MAX_FILES: "300"
+      EXPRESSIVECSS_MCP_QA_MAX_MB: "2"