raven-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Cunliffe
+
+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,72 @@
+# Raven MCP
+
+**Odin's ravens brought back knowledge of the world — Raven brings back design intelligence.**
+
+A design knowledge MCP server that Claude can query when generating UI. Three layers: principles, patterns, and business strategy.
+
+## What it does
+
+Raven gives Claude access to a comprehensive design knowledge base:
+
+- **Principles** — Nielsen's 10 Heuristics, all 21 Laws of UX, Gestalt principles, WCAG accessibility, typography rules, color theory, mobile UX, and D4D framework
+- **Patterns** — Proven UI patterns for signup flows, pricing pages, navigation, forms, landing pages, dashboards, modals, empty/error/loading states, CTAs, social proof, and mobile conversion
+- **Business** — Monetization models, retention strategies, onboarding optimization, growth mechanics, and product metrics frameworks
+- **Tokens** — Design system tokens for Stripe, Linear, and more (registry of 7 systems, 2 fully populated)
+
+## Setup
+
+```bash
+cd raven-mcp
+npm install
+npm run build
+```
+
+## Add to Claude Code
+
+Add to your Claude Code MCP config (`~/.claude/claude_desktop_config.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "raven": {
+      "command": "node",
+      "args": ["/path/to/raven-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_principles` | Get design principles relevant to a UI context |
+| `get_pattern` | Get proven patterns for a specific UI type |
+| `get_business_strategy` | Get business/monetization strategies |
+| `evaluate_design` | Evaluate a design description against principles |
+| `search_knowledge` | Search across all principles, patterns, and strategies |
+| `get_checklist` | Get a pre-publish checklist for a UI type |
+| `get_d4d_framework` | Get Design for Delight framework templates |
+| `list_design_systems` | Browse available design systems |
+| `get_design_system` | Get tokens for a specific design system |
+| `compose_system` | Mix tokens from different systems |
+
+## Development
+
+```bash
+npm run dev    # Run with tsx (hot reload)
+npm run build  # Compile TypeScript
+npm start      # Run compiled output
+```
+
+## Data structure
+
+All knowledge lives in `src/data/` as static JSON files:
+
+```
+src/data/
+  principles/   # Nielsen, Laws of UX, Gestalt, accessibility, typography, color, mobile, D4D
+  patterns/     # signup, pricing, nav, forms, landing, dashboard, modals, empty/error/loading, CTA, social proof, mobile
+  business/     # monetization, retention, onboarding, growth, metrics
+  tokens/       # registry.json + systems/ (stripe.json, linear.json)
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};