Claude-Cursor MCP Bridge

Lets Claude.ai talk directly to your Cursor editor — read files, write code, get selections, and more.

📖 Full setup guide + download → one06cm127.github.io/claude-cursor-mcp

⭐ If this actually worked for you, drop a star — it helps more people find it!

💬 Heads up — I vibe coded this whole thing, so if something's broken or you need help setting it up, just ask Claude lol

What's Included

• cursor-mcp-bridge-0.0.1.vsix — Cursor/VS Code extension (install this first)
• server.py — MCP server that connects Claude.ai to the extension
• package.json — Extension manifest

Requirements

• Cursor or VS Code
• Python 3.8+
• uv or pip
• Claude.ai account (Pro plan supports MCP)

Setup

See the full installation guide at the link above, or follow the steps below.

Step 1 — Install the Cursor Extension

1. Open Cursor
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Type Extensions: Install from VSIX
4. Select cursor-mcp-bridge-0.0.1.vsix
5. Reload Cursor — you should see "Claude-Cursor MCP Bridge started on port 9877"

Step 2 — Install Python Dependencies

pip install mcp

Or with uv:

uv pip install mcp

Step 3 — Configure Claude.ai

Go to Claude.ai → Settings → Integrations → Add MCP Server and add:

{
  "mcpServers": {
    "cursor": {
      "command": "python",
      "args": ["/full/path/to/server.py"]
    }
  }
}

Replace /full/path/to/server.py with the actual path where you saved server.py.

Step 4 — Test It

In Claude.ai, try: "What files do I have open in Cursor?"

Available Tools

| Tool | Description | |------|-------------| | get_open_files | List all open files | | get_active_file | Get the focused file's content | | get_file_content | Read any file by path | | write_file | Write/overwrite a file | | insert_at_cursor | Insert text at cursor position | | get_selection | Get selected text | | replace_selection | Replace selected text | | open_file | Open a file in the editor | | get_workspace_folder | Get current project path | | show_message | Show a notification in Cursor |

How It Works

The extension runs a local TCP server on port 9877. The Python MCP server connects Claude.ai to this socket, translating MCP tool calls into editor commands.

License

MIT