@redsift/ds-mcp-server 12.5.3-alpha.2 → 12.5.3-alpha.4

package/README.md

@@ -2,7 +2,28 @@
 
 A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that gives AI assistants deep knowledge of the Red Sift Design System. It provides tools for component search, prop documentation, code generation, design token lookup, and composition pattern guidance.
 
-## Quick Start
+> **Looking for a generic HTTP retrieval API instead?** See the sibling [@redsift/ds-rag-server](https://www.npmjs.com/package/@redsift/ds-rag-server) — same data, but exposed as a `POST /retrieve` HTTP endpoint with semantic + BM25 search. Built for chatbots, docs search boxes, and custom agentic pipelines (LangGraph, Vercel AI SDK). Use MCP for IDE coding agents; use RAG for everything else. [Comparison](https://design-system.redsift.io/introduction/rag-server#mcp-vs-rag).
+
+## Install from public npm
+
+The published package is available on the public npm registry. No `.npmrc` configuration or authentication is required:
+
+```bash
+npx @redsift/ds-mcp-server
+```
+
+Or add it to an AI client's MCP configuration (e.g. VS Code, Claude Desktop) as a stdio server invoking `npx @redsift/ds-mcp-server`.
+
+### Internal alternative: GitHub Packages
+
+The same versions are also published to GitHub Packages for internal consumers. To install from there, configure an `.npmrc` with the `@redsift` scope mapped to `https://npm.pkg.github.com` and authenticate with a GitHub Personal Access Token that has `read:packages`:
+
+```
+@redsift:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_PAT}
+```
+
+## Local development
 
 ```bash
 # From the design-system repo root:
@@ -201,3 +222,26 @@ Or verify in VS Code by opening Copilot Chat and asking:
 
 - "Search for button components in the design system" → should call `search_components`
 - "What props does DataGrid accept?" → should call `get_component_props`
+
+## Releasing
+
+The MCP server is published to two registries. Both publishes are required to keep them in sync.
+
+1. **GitHub Packages (CI).** Trigger [`.github/workflows/publish-mcp.yml`](../../.github/workflows/publish-mcp.yml) via the Actions UI.
+2. **Public npm (manual).** From a clean checkout of the merged release branch:
+
+   ```bash
+   npm whoami --registry=https://registry.npmjs.org   # confirm logged in
+   cd apps/mcp-server
+   npm pack --dry-run                                  # inspect tarball file list
+   npm publish                                         # real publish
+   ```
+
+   `prepublishOnly` runs `bundle-data` and `build` automatically, so `dist/` and `data/` are guaranteed fresh. The `files` allowlist in `package.json` ensures only `dist/`, `data/`, and `consumer-instructions/` are shipped.
+
+After both publishes, verify with:
+
+```bash
+npm view @redsift/ds-mcp-server --registry=https://registry.npmjs.org
+npm view @redsift/ds-mcp-server --registry=https://npm.pkg.github.com
+```

package/data/docs/components.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "Red Sift Design System",
   "version": "12.3.0",
-  "generated": "2026-04-28T12:45:40.299Z",
+  "generated": "2026-05-06T13:08:06.968Z",
   "repository": "https://github.com/redsift/design-system",
   "documentation": "https://design-system.redsift.io",
   "packages": [

package/data/docs/llms-full.txt

@@ -3,7 +3,7 @@
 This file contains comprehensive documentation for all components in the Red Sift Design System.
 It is optimized for LLM consumption and includes props, types, defaults, and usage examples.
 
-Generated: 2026-04-28T12:45:40.290Z
+Generated: 2026-05-06T13:08:06.962Z
 Total Components: 228
 
 ---

package/data/metadata.json

@@ -1,4 +1,4 @@
 {
-  "generatedAt": "2026-04-28T16:54:04.605Z",
-  "commitSha": "94a0d7a7f2af0038291927036e981950a7f6144f"
+  "generatedAt": "2026-05-06T14:03:23.121Z",
+  "commitSha": "3fdfd597177b65f2044cd756e14dc42782a6a9e6"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redsift/ds-mcp-server",
-  "version": "12.5.3-alpha.2",
+  "version": "12.5.3-alpha.4",
   "private": false,
   "type": "module",
   "description": "MCP server for the Red Sift Design System — provides component lookup, prop documentation, and code generation tools for AI assistants.",
@@ -33,7 +33,7 @@
     "typescript": "^5.8.0"
   },
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
-  "gitHead": "94a0d7a7f2af0038291927036e981950a7f6144f"
+  "gitHead": "3fdfd597177b65f2044cd756e14dc42782a6a9e6"
 }