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