@uni-design-system/uni-mcp 4.0.0

package/dist/http.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import {
+  createUniServer,
+  meta
+} from "./chunk-WTQ4AVHO.js";
+
+// src/server/http.ts
+import { createServer } from "http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+var PORT = Number(process.env.PORT ?? 8080);
+var HOST = process.env.HOST ?? "0.0.0.0";
+var TOKEN = process.env.UNI_MCP_TOKEN;
+var ALLOWED_HOSTS = process.env.UNI_ALLOWED_HOSTS?.split(",").map((h) => h.trim()).filter(Boolean);
+function send(res, status, body) {
+  const payload = typeof body === "string" ? body : JSON.stringify(body);
+  res.writeHead(status, { "Content-Type": typeof body === "string" ? "text/plain" : "application/json" });
+  res.end(payload);
+}
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => {
+      const raw = Buffer.concat(chunks).toString("utf8");
+      if (!raw) return resolve(void 0);
+      try {
+        resolve(JSON.parse(raw));
+      } catch (e) {
+        reject(e);
+      }
+    });
+    req.on("error", reject);
+  });
+}
+function authorized(req) {
+  if (!TOKEN) return true;
+  const header = req.headers.authorization ?? "";
+  return header === `Bearer ${TOKEN}`;
+}
+function rpcError(res, status, message) {
+  send(res, status, { jsonrpc: "2.0", error: { code: -32e3, message }, id: null });
+}
+async function handleMcp(req, res) {
+  if (!authorized(req)) return rpcError(res, 401, "Unauthorized");
+  const server = createUniServer();
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: void 0,
+    enableJsonResponse: true,
+    ...ALLOWED_HOSTS?.length ? { enableDnsRebindingProtection: true, allowedHosts: ALLOWED_HOSTS } : {}
+  });
+  res.on("close", () => {
+    transport.close();
+    server.close();
+  });
+  try {
+    await server.connect(transport);
+    const body = await readBody(req);
+    await transport.handleRequest(req, res, body);
+  } catch (err) {
+    console.error("[uni-mcp] request error:", err);
+    if (!res.headersSent) rpcError(res, 500, "Internal server error");
+  }
+}
+var httpServer = createServer((req, res) => {
+  const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+  if (req.method === "GET" && (url.pathname === "/health" || url.pathname === "/")) {
+    return send(res, 200, { status: "ok", service: "uni-mcp", uniRelease: meta.version, ...meta.counts });
+  }
+  if (url.pathname === "/mcp") return void handleMcp(req, res);
+  return send(res, 404, { error: "Not found. POST JSON-RPC to /mcp; GET /health for status." });
+});
+httpServer.listen(PORT, HOST, () => {
+  console.error(`[uni-mcp] HTTP server on http://${HOST}:${PORT}/mcp (Uni v${meta.version})`);
+  if (!TOKEN) console.error("[uni-mcp] WARNING: no UNI_MCP_TOKEN set - endpoint is unauthenticated.");
+});
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/http.ts"],"sourcesContent":["/**\n * HTTP entry — Streamable HTTP transport for a shared, always-current team\n * endpoint. Runs stateless (a fresh server+transport per request) so it scales\n * horizontally and is trivial to host on Render.\n *\n * Env:\n *   PORT               port to bind (Render sets this)               default 8080\n *   HOST               bind address                                  default 0.0.0.0\n *   UNI_MCP_TOKEN      if set, require `Authorization: Bearer <it>`  default none\n *   UNI_ALLOWED_HOSTS  comma list for DNS-rebinding protection       default none\n */\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http';\nimport { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';\nimport { createUniServer } from './core.js';\nimport { meta } from './store.js';\n\nconst PORT = Number(process.env.PORT ?? 8080);\nconst HOST = process.env.HOST ?? '0.0.0.0';\nconst TOKEN = process.env.UNI_MCP_TOKEN;\nconst ALLOWED_HOSTS = process.env.UNI_ALLOWED_HOSTS?.split(',').map((h) => h.trim()).filter(Boolean);\n\nfunction send(res: ServerResponse, status: number, body: unknown) {\n  const payload = typeof body === 'string' ? body : JSON.stringify(body);\n  res.writeHead(status, { 'Content-Type': typeof body === 'string' ? 'text/plain' : 'application/json' });\n  res.end(payload);\n}\n\nfunction readBody(req: IncomingMessage): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on('data', (c) => chunks.push(c as Buffer));\n    req.on('end', () => {\n      const raw = Buffer.concat(chunks).toString('utf8');\n      if (!raw) return resolve(undefined);\n      try {\n        resolve(JSON.parse(raw));\n      } catch (e) {\n        reject(e);\n      }\n    });\n    req.on('error', reject);\n  });\n}\n\nfunction authorized(req: IncomingMessage): boolean {\n  if (!TOKEN) return true;\n  const header = req.headers.authorization ?? '';\n  return header === `Bearer ${TOKEN}`;\n}\n\n/** JSON-RPC error envelope for pre-transport failures. */\nfunction rpcError(res: ServerResponse, status: number, message: string) {\n  send(res, status, { jsonrpc: '2.0', error: { code: -32000, message }, id: null });\n}\n\nasync function handleMcp(req: IncomingMessage, res: ServerResponse) {\n  if (!authorized(req)) return rpcError(res, 401, 'Unauthorized');\n\n  // Stateless: isolate each request in its own server+transport instance.\n  const server = createUniServer();\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: undefined,\n    enableJsonResponse: true,\n    ...(ALLOWED_HOSTS?.length ? { enableDnsRebindingProtection: true, allowedHosts: ALLOWED_HOSTS } : {}),\n  });\n\n  res.on('close', () => {\n    transport.close();\n    server.close();\n  });\n\n  try {\n    await server.connect(transport);\n    const body = await readBody(req);\n    await transport.handleRequest(req, res, body);\n  } catch (err) {\n    console.error('[uni-mcp] request error:', err);\n    if (!res.headersSent) rpcError(res, 500, 'Internal server error');\n  }\n}\n\nconst httpServer = createServer((req, res) => {\n  const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);\n\n  if (req.method === 'GET' && (url.pathname === '/health' || url.pathname === '/')) {\n    return send(res, 200, { status: 'ok', service: 'uni-mcp', uniRelease: meta.version, ...meta.counts });\n  }\n  if (url.pathname === '/mcp') return void handleMcp(req, res);\n  return send(res, 404, { error: 'Not found. POST JSON-RPC to /mcp; GET /health for status.' });\n});\n\nhttpServer.listen(PORT, HOST, () => {\n  console.error(`[uni-mcp] HTTP server on http://${HOST}:${PORT}/mcp (Uni v${meta.version})`);\n  if (!TOKEN) console.error('[uni-mcp] WARNING: no UNI_MCP_TOKEN set - endpoint is unauthenticated.');\n});\n"],"mappings":"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","names":[]}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+/**
+ * Server core — builds a fully-wired `McpServer` (tools + resources) over the
+ * in-memory Uni index. Transport-agnostic: `stdio.ts` and `http.ts` both call
+ * `createUniServer()`, so local and remote share exactly one implementation.
+ */
+
+declare function createUniServer(): McpServer;
+
+export { createUniServer };

package/dist/server.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  createUniServer
+} from "./chunk-WTQ4AVHO.js";
+export {
+  createUniServer
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/stdio.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import {
+  createUniServer
+} from "./chunk-WTQ4AVHO.js";
+
+// src/server/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+async function main() {
+  const server = createUniServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("[uni-mcp] stdio server ready");
+}
+main().catch((err) => {
+  console.error("[uni-mcp] fatal:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/stdio.ts"],"sourcesContent":["/**\n * Stdio entry — the local transport. Runs as a spawned process wired into a\n * client's MCP config (Claude Code/Desktop, Cursor, ...). Zero infra, offline.\n *\n *   npx @uni-design-system/uni-mcp\n */\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { createUniServer } from './core.js';\n\nasync function main() {\n  const server = createUniServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  // Never write to stdout here — stdout is the JSON-RPC channel.\n  console.error('[uni-mcp] stdio server ready');\n}\n\nmain().catch((err) => {\n  console.error('[uni-mcp] fatal:', err);\n  process.exit(1);\n});\n"],"mappings":";;;;;;AAMA,SAAS,4BAA4B;AAGrC,eAAe,OAAO;AACpB,QAAM,SAAS,gBAAgB;AAC/B,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAE9B,UAAQ,MAAM,8BAA8B;AAC9C;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,oBAAoB,GAAG;AACrC,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@uni-design-system/uni-mcp",
+  "version": "4.0.0",
+  "license": "MIT",
+  "description": "Model Context Protocol server for the Uni Design System — gives AI coding assistants an authoritative interface to Uni components, tokens, themes, and guidelines.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uni-design-system/uni",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "private": false,
+  "type": "module",
+  "bin": {
+    "uni-mcp": "./dist/stdio.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build-index": "tsx src/build/index.ts",
+    "build": "pnpm build-index && tsup",
+    "build:server": "tsup",
+    "dev": "tsx watch src/server/stdio.ts",
+    "serve:http": "tsx src/server/http.ts",
+    "start": "node dist/http.js",
+    "inspect": "pnpm dlx @modelcontextprotocol/inspector tsx src/server/stdio.ts",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@uni-design-system/tsconfig": "workspace:*",
+    "@uni-design-system/uni-core": "workspace:*",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.0",
+    "typescript": "~5.9.0"
+  }
+}