Cursor MCP Manager
An MCP (Model Context Protocol) server that allows you to manage Cursor IDE's MCP configuration through tools.
Features
- List MCP Servers: View all configured MCP servers
- Add MCP Server: Add new MCP servers to your configuration (STDIO or HTTP)
- Remove MCP Server: Remove existing MCP servers
- Update MCP Server: Modify server configurations
- Refresh Server: Restart a specific MCP server with automatic process cleanup
- Kill Server: Manually stop a running MCP server
- Process Monitoring: Check server status and running processes
- Log Collection: View logs from running MCP servers
- Cross-Platform: Works on Windows, macOS, and Linux
- Docker Support: Special handling for Docker-based MCP servers
Note: Cursor automatically detects changes to the mcp.json file and reloads servers without requiring a restart.
Installation
Quick Install with uvx (Recommended)
The simplest way to use cursor-mcp is with uvx (no installation required!):
{
"mcpServers": {
"cursor-manager": {
"command": "uvx",
"args": ["cursor-mcp"]
}
}
}
That's it! This will automatically download and run the latest version from PyPI.
Install from PyPI
# Install globally as a tool
uv tool install cursor-mcp
# Or use pip
pip install cursor-mcp
From source
git clone https://github.com/hud-evals/hud-cursor-manager
cd hud-cursor-manager
uv sync
uv run cursor-mcp
How it Works
- First Connection: When Cursor starts the STDIO proxy, it automatically spawns a persistent HTTP server in the background
- Subsequent Connections: New Cursor windows connect to the existing HTTP server
- Shared State: All windows share the same server state, logs, and configuration
- Persistence: The HTTP server continues running even after all Cursor windows are closed
Stopping the Background Server
The HTTP server runs on port 48765 by default. To stop it:
# Using the manager CLI
uvx --from cursor-mcp cursor-manager stop
# Or find and kill the process manually
# Windows:
netstat -ano | findstr :48765
taskkill /F /PID <PID>
# macOS/Linux:
lsof -i :48765
kill -9 <PID>
You can also set a custom port using the CURSOR_MCP_PORT environment variable.
Usage
Once configured, the following tools are available in Cursor:
- list_mcp_servers - View all configured MCP servers
- add_mcp_server - Add a new MCP server configuration
- remove_mcp_server - Remove an MCP server
- update_mcp_server - Modify server settings
- refresh_mcp_server - Restart a server
- kill_mcp_server - Stop a running server
- check_server_status - Check if a server is running
- list_running_servers - List all running MCP processes
- get_server_logs - View server logs (last 100 lines)
Development
# Install dependencies
uv sync
# Run the server
uv run cursor-mcp
# Run tests
uv run pytest tests/
Known Limitations
Tool List Updates in Active Conversations
When you refresh an MCP server that has new or updated tools, the changes will be available on your next message in the conversation. Cursor refreshes the tool list when you send a new message.
Note: Simply send another message after refreshing to see the updated tools - no need to start a new conversation.
License
MIT License - see LICENSE file for details.
Metadata
Release files for cursor-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cursor_mcp-0.1.1.tar.gz | 87.0 kB | Without provenance | Details for cursor_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cursor_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for cursor_mcp-0.1.1-py3-none-any.whl |
Total release size: 112.1 kB
Release files / cursor_mcp-0.1.1.tar.gz
| Download URL | cursor_mcp-0.1.1.tar.gz |
|---|---|
| Size | 87.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f4daf55cf0f8df811ea85f85462957a89fbb835f28405e7444e073807582fbea
|
|
BLAKE2b-256 checksum How to use checksums |
c406c1aa3e382cab5a0619cda4f0824b3190155864d8bce7f1268c43142ea10d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.4
|
Release files / cursor_mcp-0.1.1-py3-none-any.whl
| Download URL | cursor_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 25.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
706a7cb480a3778cedfc83d566dc86ee12f4ea5b79a04f5994ce276ff3052d3d
|
|
BLAKE2b-256 checksum How to use checksums |
3096e196abfffa8740624555bf3585ae22b325f7fb2460d3b3e19c504a1b7c1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.4
|
Security for cursor-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.