@conciso/design-system-mcp 0.0.0-bootstrap.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Conciso GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @conciso/design-system-mcp
+
+MCP-Server für Consumer des Conciso Design System. Er beantwortet `docs-list`, `docs-show`
+und `docs-show-story` über stdio, mit den echten, dokumentierten Inputs und Outputs der
+[Angular-Lib](https://www.npmjs.com/package/@conciso/design-system-angular), nicht erfundenen.
+Die Daten stammen aus einem mitgelieferten Snapshot des Storybook-Builds derselben Version;
+der Server greift dafür nie auf ein Netzwerk zu. Beim Start vergleicht er seine Version mit der
+installierten Angular-Lib und warnt bei Abweichung, bricht aber nie ab.
+
+## Installation
+
+Zwei Wege: mit installiertem Paket, oder per `npx` ganz ohne Installation (etwa wenn dein
+Projekt die CSS-Schicht nur kopiert statt installiert hat, dann mit fester Version statt
+`latest`, passend zum kopierten Stand):
+
+```bash
+npm i -D @conciso/design-system-mcp
+```
+
+```bash
+npx -y @conciso/design-system-mcp@<Version>
+```
+
+`<Version>` ist die Version der CSS-Schicht, die dein Projekt kopiert hat. Diesen
+MCP-Server gibt es erst ab einer späteren Version als die CSS-Schicht; welche Versionen
+existieren, zeigt `npm view @conciso/design-system-mcp versions`. Ist dein Stand älter, nimm
+die älteste verfügbare Version und aktualisiere die Kopie bei Gelegenheit.
+
+## Einbinden in Claude Code
+
+Mit installiertem Paket, als `.mcp.json` im Projekt committen:
+
+```json
+{
+  "mcpServers": {
+    "conciso-ds": {
+      "command": "npx",
+      "args": ["cds-mcp"]
+    }
+  }
+}
+```
+
+Ohne installiertes Paket dieselbe Datei, nur mit fester Version statt `cds-mcp`:
+
+```json
+{
+  "mcpServers": {
+    "conciso-ds": {
+      "command": "npx",
+      "args": ["-y", "@conciso/design-system-mcp@<Version>"]
+    }
+  }
+}
+```
+
+Die vollständige Einrichtung, inklusive weiterer KI-Assistenten (VS Code, Cursor) und dem
+Weg ohne Angular, steht auf der Storybook-Seite
+[„Einrichtung“](https://conciso.github.io/conciso-design-system/?path=/docs/grundlagen-einrichtung--%C3%BCbersicht).

package/bin/cds-mcp.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// Dünner Einstiegspunkt für das `bin` cds-mcp — die eigentliche Server-Logik lebt in
+// src/server.mjs, damit sie ohne Kindprozess-Spawn importierbar und testbar bleibt.
+import { startServer } from '../src/server.mjs';
+
+startServer().catch((err) => {
+  console.error('[cds-mcp] Start fehlgeschlagen:', err);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@conciso/design-system-mcp",
+  "version": "0.0.0-bootstrap.0",
+  "description": "MCP-Server für Consumer des Conciso Design System, beantwortet docs-list, docs-show und docs-show-story über stdio aus einem mitgelieferten Storybook-Snapshot, ohne Netzzugriff.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/conciso/conciso-design-system.git"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com/"
+  },
+  "bin": {
+    "cds-mcp": "bin/cds-mcp.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin",
+    "src",
+    "snapshot",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:snapshot": "node scripts/build-snapshot.mjs",
+    "prepack": "node scripts/prepack.mjs",
+    "test": "node --test test/*.test.mjs",
+    "test:smoke": "node scripts/smoke-test.mjs",
+    "test:eval-checker": "node --test eval/checker.test.mjs",
+    "eval": "node eval/run-eval.mjs",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@storybook/mcp": "10.6.0",
+    "@tmcp/adapter-valibot": "^0.1.6",
+    "@tmcp/transport-stdio": "^0.5.0",
+    "tmcp": "^1.20.0",
+    "valibot": "^1.5.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.6.0",
+    "globals": "^17.12.0"
+  }
+}