Cursor Claude Code Setup

Auto-configure MCP servers for Cursor and Claude Code, plus install BMAD Framework.

npx cursor-claude-setup-2025

---

What This Does

**Prompts you for**:

1. Your name
2. Which components to install (checkboxes - all selected by default):
   • Cursor IDE configuration
   • Claude Code CLI with MCP servers
   • Serena MCP Server
   • BMAD Framework
3. Create workspace folder? (yes/no)
4. Open docs when done? (yes/no)

**Then automatically**:

1. Checks prerequisites (Node 18+, Claude CLI, uv for Serena)
2. Installs selected components
3. Auto-configures MCP servers (Exa, Firecrawl, Serena):
   • Writes ./.mcp.json (in your current directory)
   • Merges ~/.cursor/mcp.json (backs up first)
   • Merges ~/.claude/config.json (backs up first)
4. Optional: Creates ~/cursor-claude-course workspace
5. Shows results and next steps

---

Prerequisites

**You need Node.js 18+** to run this installer (includes npm/npx).

Don't have Node? See `docs/INSTALL-NODE.md` or ask Cursor/Claude Code to help you install it.

---

Files Created

In Your Current Directory (where you run npx):

./
├── .mcp.json                    # MCP config (Exa, Firecrawl, Serena)
├── .mcp.env.example             # Where to add your API keys
├── .claude/commands/            # 2 slash commands
└── .cursor/commands/            # Same 2 commands

Global (Home Directory):

~/
├── .cursorrules                 # Cursor config (personalized with your name)
├── .cursor/mcp.json             # MCP servers (merged, backed up)
├── .claude/config.json          # MCP servers (merged, backed up)
└── .claude/README-MCP-ENV.md    # How to export API keys

Optional Workspace:

~/cursor-claude-course/
├── week-1-foundations/
├── week-2-cursor-advanced/
├── ...8 week folders
├── capstone-projects/
├── resources/
└── notes/

---

After Installation

1. Add API Keys

The installer writes **placeholders** (`${EXA_API_KEY}`, `${FIRECRAWL_API_KEY}`) in your c