v0.0.1  ·  open source

Let Claude talk
to your Cursor editor

A local MCP bridge that gives Claude.ai direct access to your open files, editor state, and workspace — so you can describe changes and have them applied instantly.

↓ Download View setup guide →

Architecture

How it works

Two lightweight pieces work together locally on your machine — nothing is sent to the cloud except your normal Claude.ai messages.

you
Claude.ai
→
python
server.py
→
TCP :9877
localhost
→
extension
Cursor
All traffic stays on your machine · Port 9877 · No cloud relay

Setup

Installation guide

✦ You'll need Cursor (or VS Code), Python 3.8+, and a Claude.ai Pro account with MCP enabled.
1
Install the Cursor extension

Open Cursor, press Ctrl+Shift+P (or Cmd+Shift+P on Mac), and run Extensions: Install from VSIX. Select the .vsix file from the download.

After reloading Cursor you should see a notification: "Claude-Cursor MCP Bridge started on port 9877"

⚠ The extension must be running before Claude can connect. If you restart Cursor it will start automatically.
2
Install the Python dependency

The MCP server only needs one package. Run one of these in your terminal:

terminal 
pip install mcp

Or if you use uv:

terminal 
uv pip install mcp
3
Save server.py somewhere permanent

Put server.py in a folder you won't accidentally delete. For example:

example paths
# Windows
C:\Users\YourName\mcp\server.py

# Mac / Linux
~/mcp/server.py

Note the full path — you'll need it in the next step.

4
Add the MCP server to Claude.ai

Go to Claude.ai → Settings → Integrations → Add MCP Server and paste the following, replacing the path with where you saved server.py:

claude_desktop_config.json 
{
  "mcpServers": {
    "cursor": {
      "command": "python",
      "args": ["/full/path/to/server.py"]
    }
  }
}
✦ On Windows use double backslashes or forward slashes in the path, e.g. "C:/Users/YourName/mcp/server.py"

Verify it's working

Open a project in Cursor, then in Claude.ai try:

example prompts
"What files do I have open in Cursor?"
"Read my active file and suggest improvements."
"Add a comment at the top of the active file."

Reference

Available tools

Claude can use these tools automatically when you ask it to interact with your editor. You don't need to call them by name.

get_open_files
List every file currently open in Cursor
get_active_file
Read the focused/active file's full content
get_file_content
Read any file by its path
write_file
Write or overwrite a file with new content
insert_at_cursor
Insert text at the current cursor position
get_selection
Get the currently highlighted/selected text
replace_selection
Replace selected text with new content
open_file
Open any file in the Cursor editor
get_workspace_folder
Get the current project's root folder path
show_message
Show an info, warning, or error notification in Cursor

Download

Get the files

Claude-Cursor MCP Bridge v0.0.1

Everything you need. No build step required — just install the extension and run the Python server.

⬡ cursor-mcp-bridge-0.0.1.vsix Cursor/VS Code extension
𝛑 server.py MCP server
{ } package.json Extension manifest
📄 README.md Quick-start guide
✦ node_modules is not included — it's generated automatically. If you want to repackage the extension yourself, run npm install then npm run package inside the extension folder.
↓ Download ZIP

MIT licensed · runs entirely on your local machine

Help

Troubleshooting

"Cannot connect to Cursor"
The extension isn't running. Open Cursor and check the status bar or notification area. Try reloading the window via Ctrl+Shift+P → Reload Window.
Claude doesn't see the MCP server
Make sure the path in your Claude config is the full absolute path to server.py. On Windows, use forward slashes or double backslashes.
ModuleNotFoundError: mcp
Run pip install mcp in the same Python environment that Claude.ai is configured to use. If you use multiple Python versions, specify the full path: "command": "python3".
Port 9877 already in use
Another process is occupying port 9877. Close it, or edit both server.py and extension.js to use a different port number (change 9877 in both files, then repackage the extension).