@webdesignhot/design-md-mcp 0.1.0 → 0.1.2

package/README.md

@@ -1,15 +1,15 @@
 # @webdesignhot/design-md-mcp
 
-> MCP server exposing the [webdesignhot.com](https://www.webdesignhot.com/design.md/) DESIGN.md catalog (254+ real-brand design systems) to Claude Desktop, Claude Code, Cursor, Cline, and any other MCP-aware AI agent.
+> MCP server exposing the [webdesignhot.com](https://www.webdesignhot.com/design.md/) DESIGN.md catalog (285+ real-brand design systems) to Claude Code, Claude Desktop, Cursor, Codex, Cline, and any other MCP-aware AI agent.
 
 ## Why
 
-When an AI coding agent picks up a project, it usually has no idea what your visual style is. You can paste tokens into the system prompt, hand it a Figma export, or — best — point it at a single `DESIGN.md` file. This MCP server takes that one step further: agents can browse 254+ real-brand design systems (Linear, Stripe, Vercel, Anthropic, Notion, Apple, Tesla, BMW, …) and install one in your project without you ever leaving the chat.
+When an AI coding agent picks up a project, it usually has no idea what your visual style is. You can paste tokens into the system prompt, hand it a Figma export, or — best — point it at a single `DESIGN.md` file. This MCP server takes that one step further: agents can browse 285+ real-brand design systems (Linear, Stripe, Vercel, Anthropic, Notion, Apple, Tesla, BMW, …) and install one in your project without you ever leaving the chat.
 
 ## Tools
 
 - **`list_designs`** — list every design (with `featured_only` / `category` / `tag` filters)
-- **`get_design`** — full DESIGN.md/v1.5 source for a slug
+- **`get_design`** — full DESIGN.md (webdesignhot/0.1) source for a slug
 - **`search_designs`** — fuzzy search by name, tagline, tags, categories
 - **`diff_designs`** — token-level diff between any two designs
 - **`export_design`** — render tokens to tailwind / css / dtcg / figma
@@ -17,9 +17,46 @@ When an AI coding agent picks up a project, it usually has no idea what your vis
 
 ## Install
 
-### Claude Desktop / Claude Code
+### Claude Code (CLI / IDE extension)
 
-Add to your `~/Library/Application Support/Claude/claude_desktop_config.json` (or the equivalent on Windows / Linux):
+Easiest — let the `claude` CLI write the config for you. Pick a scope:
+
+```bash
+# Local (default) — only this project, only you. Written to ~/.claude.json
+# under the project key. Teammates won't see it.
+claude mcp add design-md -- npx -y @webdesignhot/design-md-mcp
+
+# Project — committed to the repo's .mcp.json so teammates get it on clone.
+claude mcp add --scope project design-md -- npx -y @webdesignhot/design-md-mcp
+
+# User — every project on your machine, written to ~/.claude.json globals.
+claude mcp add --scope user design-md -- npx -y @webdesignhot/design-md-mcp
+```
+
+Verify with `/mcp` inside Claude Code — `design-md` should be listed with 6 tools (`list_designs`, `get_design`, `search_designs`, `diff_designs`, `export_design`, `install_design`).
+
+Manual alternative for `--scope project` — drop `.mcp.json` in the repo root:
+
+```json
+{
+  "mcpServers": {
+    "design-md": {
+      "command": "npx",
+      "args": ["-y", "@webdesignhot/design-md-mcp"]
+    }
+  }
+}
+```
+
+> **Note:** Claude Code does **not** read `claude_desktop_config.json` — that's Claude Desktop's file. Mixing them up is the #1 wrong path.
+
+### Claude Desktop
+
+Different application, different config file. Edit:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
 
 ```json
 {
@@ -32,17 +69,46 @@ Add to your `~/Library/Application Support/Claude/claude_desktop_config.json` (o
 }
 ```
 
+Restart Claude Desktop after editing.
+
 ### Cursor
 
-In Settings → Features → MCP → "Add new MCP server":
+Drop a JSON file at one of two paths — same shape as Claude:
+
+- Global: `~/.cursor/mcp.json`
+- Project: `.cursor/mcp.json` (in repo root)
+
+```json
+{
+  "mcpServers": {
+    "design-md": {
+      "command": "npx",
+      "args": ["-y", "@webdesignhot/design-md-mcp"]
+    }
+  }
+}
+```
+
+Toggle the server on under **Settings → Features → Model Context Protocol** (or the marketplace at [cursor.directory](https://cursor.directory) for one-click adds on community servers).
+
+### Codex (OpenAI CLI / IDE extension)
+
+Codex uses **TOML**, not JSON. Edit:
+
+- Global: `~/.codex/config.toml`
+- Project: `.codex/config.toml` (for trusted projects only)
+
+```toml
+[mcp_servers.design-md]
+command = "npx"
+args = ["-y", "@webdesignhot/design-md-mcp"]
+```
 
-- **Name**: `design-md`
-- **Type**: `command`
-- **Command**: `npx -y @webdesignhot/design-md-mcp`
+The CLI and the IDE extension share this config — set it once, both clients see it.
 
-### Cline / Roo / etc.
+### Cline / Roo / Continue / etc.
 
-Any MCP client supporting stdio transports works. After install the binary is `design-md-mcp` (no scope) — run it directly, or invoke via `npx -y @webdesignhot/design-md-mcp`.
+Any MCP client supporting stdio transports works. After install the binary is exposed as `design-md-mcp` — run it directly, or invoke via `npx -y @webdesignhot/design-md-mcp`. Most clients accept the same `{ "command": "npx", "args": ["-y", "@webdesignhot/design-md-mcp"] }` JSON shape Claude uses.
 
 ## Use it
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@webdesignhot/design-md-mcp",
-  "version": "0.1.0",
-  "description": "MCP server exposing the webdesignhot.com DESIGN.md catalog (254+ real-brand design systems) to Claude Desktop, Claude Code, Cursor, Cline, and any other MCP-aware AI agent. Tools: list, get, search, diff, export.",
-  "keywords": ["mcp", "model-context-protocol", "design.md", "design-system", "ai-agents", "claude", "cursor"],
+  "version": "0.1.2",
+  "description": "MCP server exposing the webdesignhot.com DESIGN.md catalog (285+ real-brand design systems) to Claude Code, Claude Desktop, Cursor, Codex, Cline, and any other MCP-aware AI agent. Tools: list, get, search, diff, export.",
+  "keywords": ["mcp", "model-context-protocol", "design.md", "design-system", "ai-agents", "claude", "claude-code", "codex", "cursor"],
   "author": "webdesignhot",
   "license": "MIT",
   "homepage": "https://www.webdesignhot.com/design.md/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/WebDesignHot/design-md"
+    "url": "git+https://github.com/WebDesignHot/design-md.git"
   },
   "bin": {
     "design-md-mcp": "bin/design-md-mcp.mjs"

package/src/server.mjs

@@ -52,7 +52,7 @@ const TOOLS = [
   {
     name: 'get_design',
     description:
-      'Fetch the full DESIGN.md/v1.5 source for a specific design (YAML frontmatter + markdown body). The response is the exact file an agent should read as its style source of truth. Use the agent-prompt header from the file to anchor every component decision.',
+      'Fetch the full DESIGN.md (webdesignhot/0.1) source for a specific design (YAML frontmatter + markdown body). The response is the exact file an agent should read as its style source of truth. Use the agent-prompt header from the file to anchor every component decision.',
     inputSchema: {
       type: 'object',
       required: ['slug'],