diff --git a/.gitignore b/.gitignore
index 3109070..6a8d3e5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -68,3 +68,5 @@ dist/
 out/
 storybook-static/
 venv/
+# Local MCP config (generated)
+# .mcp.json
diff --git a/scripts/setup-mcp.sh b/scripts/setup-mcp.sh
new file mode 100755
index 0000000..67a867a
--- /dev/null
+++ b/scripts/setup-mcp.sh
@@ -0,0 +1,27 @@
+#!/bin/bash
+# Generate .mcp.json with absolute paths for current setup
+
+DSS_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+cat > "$DSS_ROOT/.mcp.json" << EOF
+{
+  "\$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/mcp-servers.schema.json",
+  "mcpServers": {
+    "dss": {
+      "command": "$DSS_ROOT/venv/bin/python3",
+      "args": ["$DSS_ROOT/dss-claude-plugin/servers/dss-mcp-server.py"],
+      "env": {
+        "PYTHONPATH": "$DSS_ROOT:$DSS_ROOT/dss-claude-plugin",
+        "DSS_HOME": "$DSS_ROOT/.dss",
+        "DSS_DATABASE": "$DSS_ROOT/.dss/dss.db",
+        "DSS_CACHE": "$DSS_ROOT/.dss/cache",
+        "DSS_BASE_PATH": "$DSS_ROOT"
+      },
+      "description": "Design System Server MCP - local development"
+    }
+  }
+}
+EOF
+
+echo "Generated .mcp.json for: $DSS_ROOT"
+echo "Restart Claude Code to load the DSS MCP server."