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.py

MCP 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-mcp

Or 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-mcp

Or 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_OWNER
CURSOR_WORKSPACE_PATH
CURSOR_ACCESS_TOKEN
CURSOR_CONFIG_PATH
CURSOR_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 index
ensure_codebase_indexed: trigger index creation
refresh_repo_info: refresh repo detection
list_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.

cursor-search-mcp