cursor-search-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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: code-context-v2
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
Ask your own documents and get answers that cite the source passage. Workspace knowledge bases over MCP for Cursor, Claude and any MCP client.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI-driven semantic code search via natural language queries, integrating with MCP clients like Claude Desktop to retrieve relevant code context from any codebase.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables semantic code search across indexed codebases using natural language queries, with support for CLI and MCP interfaces.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-based hybrid semantic code search over repositories, providing tools for searching code by meaning or keyword, retrieving symbol definitions, finding usages, reading chunks, and listing indexed repos.MIT
- AlicenseNot gradedqualityBmaintenanceEnables semantic code search across repositories via MCP, returning exact source excerpts with paths and line numbers.40 npm114MIT