Cursor Search MCP
Expose Cursor's semantic code search through MCP.
Requirements
- Python 3.10+
- Cursor installed and logged in (once)
- uv or pip
Cursor must index the repo. Open it in Cursor and wait for indexing to finish.
Install
git clone https://github.com/philipk19238/cursor-search-mcp.git
cd cursor-search-mcp
uv pip install -e .Run
cursor-search-mcp
# or
fastmcp run src/cursor_search_mcp/server.pyMCP Client Setup
Claude Code
claude mcp add cursor-search -- \
env CURSOR_WORKSPACE_PATH=/path/to/your/repo \
uv run --directory /path/to/cursor-search-mcp cursor-search-mcpOr add to ~/.claude.json:
{
"mcpServers": {
"cursor-search": {
"command": "env",
"args": [
"CURSOR_WORKSPACE_PATH=/path/to/your/repo",
"uv", "run", "--directory", "/path/to/cursor-search-mcp",
"cursor-search-mcp"
]
}
}
}OpenAI Codex
codex mcp add cursor-search -- \
env CURSOR_WORKSPACE_PATH=/path/to/your/repo \
uv run --directory /path/to/cursor-search-mcp cursor-search-mcpOr add to ~/.codex/config.toml:
[mcp_servers.cursor-search]
command = "env"
args = [
"CURSOR_WORKSPACE_PATH=/path/to/your/repo",
"uv", "run", "--directory", "/path/to/cursor-search-mcp",
"cursor-search-mcp"
]OpenCode
Add to opencode.json:
{
"mcp": {
"cursor-search": {
"type": "local",
"command": "env",
"args": [
"CURSOR_WORKSPACE_PATH=/path/to/your/repo",
"uv", "run", "--directory", "/path/to/cursor-search-mcp",
"cursor-search-mcp"
],
"enabled": true
}
}
}Config (optional)
CURSOR_REPO_NAME/CURSOR_REPO_OWNERCURSOR_WORKSPACE_PATHCURSOR_ACCESS_TOKENCURSOR_CONFIG_PATHCURSOR_VERSION
If the server is launched outside the repo, set CURSOR_WORKSPACE_PATH to the indexed workspace root. Startup fails if the workspace is not indexed.
Tools
codebase_search: semantic search in the indexensure_codebase_indexed: trigger index creationrefresh_repo_info: refresh repo detectionlist_indexed_repos: show locally indexed repos
Acknowledgements
Based on reverse engineering work from:
- cursor-rpc - Go library with protobuf definitions
- cursor-unchained - Cursor API reverse engineering
Disclaimer
Unofficial project; Cursor may change the API.
