Skip to main content
Glama
philipk19238

cursor-search-mcp

by philipk19238
OverviewSchemaRelated ServersScoreDiscussions
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 installed

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

How are these scores calculated?

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.

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