| Name | cursor-mcp JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | MCP server for managing Cursor IDE MCP configurations |
| upload_time | 2025-08-03 01:36:36 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT License Copyright (c) 2024 lorenss-m Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
cursor
ide
mcp
modelcontextprotocol
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Cursor MCP Manager
[](https://pypi.org/project/cursor-mcp/)
[](https://pypi.org/project/cursor-mcp/)
[](https://cursor.com/install-mcp?name=cursor-manager&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMGN1cnNvci1tY3AlMjIlN0Q%3D)
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!):
```json
{
"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
```bash
# Install globally as a tool
uv tool install cursor-mcp
# Or use pip
pip install cursor-mcp
```
### From source
```bash
git clone https://github.com/hud-evals/hud-cursor-manager
cd hud-cursor-manager
uv sync
uv run cursor-mcp
```
## How it Works
1. **First Connection**: When Cursor starts the STDIO proxy, it automatically spawns a persistent HTTP server in the background
2. **Subsequent Connections**: New Cursor windows connect to the existing HTTP server
3. **Shared State**: All windows share the same server state, logs, and configuration
4. **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:
```bash
# 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
```bash
# 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "cursor-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "cursor, ide, mcp, modelcontextprotocol",
"author": null,
"author_email": "lorenss-m <saeclmusic@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c4/06/c1aa3e382cab5a0619cda4f0824b3190155864d8bce7f1268c43142ea10d/cursor_mcp-0.1.1.tar.gz",
"platform": null,
"description": "# Cursor MCP Manager\n[](https://pypi.org/project/cursor-mcp/)\n[](https://pypi.org/project/cursor-mcp/)\n\n[](https://cursor.com/install-mcp?name=cursor-manager&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMGN1cnNvci1tY3AlMjIlN0Q%3D)\n\nAn MCP (Model Context Protocol) server that allows you to manage Cursor IDE's MCP configuration through tools.\n\n## Features\n\n- **List MCP Servers**: View all configured MCP servers\n- **Add MCP Server**: Add new MCP servers to your configuration (STDIO or HTTP)\n- **Remove MCP Server**: Remove existing MCP servers\n- **Update MCP Server**: Modify server configurations\n- **Refresh Server**: Restart a specific MCP server with automatic process cleanup\n- **Kill Server**: Manually stop a running MCP server\n- **Process Monitoring**: Check server status and running processes\n- **Log Collection**: View logs from running MCP servers\n- **Cross-Platform**: Works on Windows, macOS, and Linux\n- **Docker Support**: Special handling for Docker-based MCP servers\n\n**Note**: Cursor automatically detects changes to the `mcp.json` file and reloads servers without requiring a restart.\n\n## Installation\n\n### Quick Install with uvx (Recommended)\n\nThe simplest way to use cursor-mcp is with `uvx` (no installation required!):\n\n```json\n{\n \"mcpServers\": {\n \"cursor-manager\": {\n \"command\": \"uvx\",\n \"args\": [\"cursor-mcp\"]\n }\n }\n}\n```\n\nThat's it! This will automatically download and run the latest version from PyPI.\n\n### Install from PyPI\n\n```bash\n# Install globally as a tool\nuv tool install cursor-mcp\n\n# Or use pip\npip install cursor-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/hud-evals/hud-cursor-manager\ncd hud-cursor-manager\nuv sync\nuv run cursor-mcp\n```\n\n## How it Works\n\n1. **First Connection**: When Cursor starts the STDIO proxy, it automatically spawns a persistent HTTP server in the background\n2. **Subsequent Connections**: New Cursor windows connect to the existing HTTP server\n3. **Shared State**: All windows share the same server state, logs, and configuration\n4. **Persistence**: The HTTP server continues running even after all Cursor windows are closed\n\n### Stopping the Background Server\n\nThe HTTP server runs on port 48765 by default. To stop it:\n\n```bash\n# Using the manager CLI\nuvx --from cursor-mcp cursor-manager stop\n\n# Or find and kill the process manually\n# Windows:\nnetstat -ano | findstr :48765\ntaskkill /F /PID <PID>\n\n# macOS/Linux:\nlsof -i :48765\nkill -9 <PID>\n```\n\nYou can also set a custom port using the `CURSOR_MCP_PORT` environment variable.\n\n## Usage\n\nOnce configured, the following tools are available in Cursor:\n\n- **list_mcp_servers** - View all configured MCP servers\n- **add_mcp_server** - Add a new MCP server configuration\n- **remove_mcp_server** - Remove an MCP server\n- **update_mcp_server** - Modify server settings\n- **refresh_mcp_server** - Restart a server\n- **kill_mcp_server** - Stop a running server\n- **check_server_status** - Check if a server is running\n- **list_running_servers** - List all running MCP processes\n- **get_server_logs** - View server logs (last 100 lines)\n\n## Development\n\n```bash\n# Install dependencies\nuv sync\n\n# Run the server\nuv run cursor-mcp\n\n# Run tests\nuv run pytest tests/\n```\n\n## Known Limitations\n\n### Tool List Updates in Active Conversations\n\nWhen 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.\n\n**Note**: Simply send another message after refreshing to see the updated tools - no need to start a new conversation.\n\n## License\n\nMIT License - see LICENSE file for details.",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2024 lorenss-m Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "MCP server for managing Cursor IDE MCP configurations",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/hud-evals/hud-cursor-manager/issues",
"Documentation": "https://github.com/hud-evals/hud-cursor-manager/tree/main/README.md",
"Homepage": "https://github.com/hud-evals/hud-cursor-manager"
},
"split_keywords": [
"cursor",
" ide",
" mcp",
" modelcontextprotocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3096e196abfffa8740624555bf3585ae22b325f7fb2460d3b3e19c504a1b7c1e",
"md5": "5df633b53e5692c4569836a568402264",
"sha256": "706a7cb480a3778cedfc83d566dc86ee12f4ea5b79a04f5994ce276ff3052d3d"
},
"downloads": -1,
"filename": "cursor_mcp-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5df633b53e5692c4569836a568402264",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 25107,
"upload_time": "2025-08-03T01:36:35",
"upload_time_iso_8601": "2025-08-03T01:36:35.320670Z",
"url": "https://files.pythonhosted.org/packages/30/96/e196abfffa8740624555bf3585ae22b325f7fb2460d3b3e19c504a1b7c1e/cursor_mcp-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c406c1aa3e382cab5a0619cda4f0824b3190155864d8bce7f1268c43142ea10d",
"md5": "4b2b023811385145a65f8c6d650bec40",
"sha256": "f4daf55cf0f8df811ea85f85462957a89fbb835f28405e7444e073807582fbea"
},
"downloads": -1,
"filename": "cursor_mcp-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "4b2b023811385145a65f8c6d650bec40",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 87036,
"upload_time": "2025-08-03T01:36:36",
"upload_time_iso_8601": "2025-08-03T01:36:36.221944Z",
"url": "https://files.pythonhosted.org/packages/c4/06/c1aa3e382cab5a0619cda4f0824b3190155864d8bce7f1268c43142ea10d/cursor_mcp-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 01:36:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hud-evals",
"github_project": "hud-cursor-manager",
"github_not_found": true,
"lcname": "cursor-mcp"
}
