@preply/ds-ai-mcp 11.1.0

package/README.md

@@ -0,0 +1,50 @@
+# `@preply/ds-ai-mcp`
+
+> MCP server for the Preply Design System.
+
+Exposes all AI tools from [`@preply/ds-ai-core`](../ai-core/README.md) over the [Model Context Protocol](https://modelcontextprotocol.io/) (stdio transport), so MCP-compatible clients (Cursor, Claude Desktop, etc.) can query DS icons, tokens, and component docs.
+
+## Usage
+
+### As a standalone server
+
+```bash
+ds-mcp start
+```
+
+### Programmatic
+
+```typescript
+import { createServer } from '@preply/ds-ai-mcp';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const server = createServer();
+await server.connect(new StdioServerTransport());
+```
+
+### MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "ds-mcp": {
+      "command": "npx",
+      "args": ["@preply/ds-ai-mcp", "start"]
+    }
+  }
+}
+```
+
+## Tool annotations
+
+All registered tools are annotated as read-only, idempotent, non-destructive, and closed-world — clients can safely call them in planning/preview modes.
+
+## Development
+
+```bash
+yarn build           # Build the package
+yarn dev             # Build in watch mode
+yarn dev:inspector   # Launch with MCP Inspector for debugging
+yarn check:types     # Type-check
+yarn lint            # Lint
+```

package/dist/__tests__/create-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-server.test.d.ts.map

package/dist/__tests__/create-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-server.test.ts"],"names":[],"mappings":""}

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,12 @@
+import { n as package_default, t as createServer } from "./create-server-LzOTK9vc.js";
+import { program } from "commander";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region src/bin.ts
+program.name(Object.keys(package_default.bin)[0]).description(package_default.description).version(package_default.version, "-v, --version", "Output the version number").usage("<command>");
+program.command("start").description("Start the MCP server").action(async () => {
+	const transport = new StdioServerTransport();
+	await createServer().connect(transport);
+});
+program.parse();
+//#endregion
+export {};