Local Code Indexing for Cursor

Um servidor baseado em Python que indexa localmente bases de código usando ChromaDB para fornecer busca semântica para ferramentas como Cursor.

Documentação

Local Code Indexing for Cursor

Um servidor experimental baseado em Python que indexa localmente bases de código usando ChromaDB e fornece uma ferramenta de busca semântica via um servidor MCP (Model Context Protocol) para ferramentas como o Cursor.

Configuração

  1. Clone e entre no repositório:

    git clone <repository-url>
    cd cursor-local-indexing
    
  2. Crie um arquivo .env copiando .env.example:

    cp .env.example .env
    
  3. Configure seu arquivo .env:

    PROJECTS_ROOT=~/your/projects/root    # Path to your projects directory
    FOLDERS_TO_INDEX=project1,project2    # Comma-separated list of folders to index
    

    Exemplo:

    PROJECTS_ROOT=~/projects
    FOLDERS_TO_INDEX=project1,project2
    
  4. Inicie o servidor de indexação:

    docker-compose up -d
    
  5. Configure o Cursor para usar o servidor de busca local: Crie ou edite ~/.cursor/mcp.json:

    {
      "mcpServers": {
        "workspace-code-search": {
          "url": "http://localhost:8978/sse"
        }
      }
    }
    
  6. Reinicie o Cursor IDE para aplicar as alterações.

O servidor começará a indexar seus projetos especificados, e você poderá usar a busca semântica de código dentro do Cursor quando esses projetos estiverem ativos.

  1. Abra um projeto que você configurou como indexado.

Crie um arquivo .cursorrules e adicione o seguinte:

<instructions>
For any request, use the @search_code tool to check what the code does.
Prefer that first before resorting to command line grepping etc.
</instructions>
  1. Comece a usar o modo Agente do Cursor e veja-o fazendo buscas vetoriais locais!