Skip to main content
Glama
philipk19238

cursor-search-mcp

by philipk19238
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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.

Related MCP server: grepsense

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:

Disclaimer

Unofficial project; Cursor may change the API.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • zoekt-mcp

    radiovisual
    A
    license
    A
    quality
    C
    maintenance
    Exposes Sourcegraph Zoekt code search to MCP-capable AI agents, enabling fast, indexed regex/symbol-aware code search over repositories.
    3
    64 PyPI
    2
    MIT

  • grepsense

    alaiba
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides two-modal code search (lexical via Zoekt and semantic via ChromaDB embeddings) for AI coding agents through MCP tools, enabling fast regex and meaning-based code lookup.
    MIT

  • Cortex

    Remskill
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding assistants to semantically search and retrieve relevant code patterns, documentation, and implementations from a codebase via MCP tools.
    8
    MIT