Skip to main content
Glama
philipk19238

cursor-search-mcp

by philipk19238

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.

F
license - not found
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • 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
    2
    MIT
  • A
    license
    Not graded
    quality
    B
    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
  • 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.
    6
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI-driven semantic code search via natural language queries, integrating with MCP clients like Claude Desktop to retrieve relevant code context from any codebase.
    MIT

View all related MCP servers

Related MCP Connectors

  • Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

  • Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

  • Agentic search over your Dewey document collections from any MCP-compatible client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/philipk19238/cursor-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server