Chroma MCP Server

Servidor MCP Chroma

Uma integração de servidor Model Context Protocol (MCP) para Chroma, o banco de dados de embeddings de código aberto.

Visão Geral

O Servidor MCP Chroma cria uma "memória de trabalho" persistente e pesquisável para desenvolvimento assistido por IA:

• Recuperação Automática de Contexto: Assistentes de IA podem consultar informações relevantes de sessões anteriores
• Persistência Gerenciada pelo Desenvolvedor: Armazene decisões e insights importantes no ChromaDB via MCP
• Integração de Segundo Cérebro: Integra-se a fluxos de trabalho de IDE para criar um hub de conhecimento unificado

Principais recursos:

• Indexação Automática de Código: Rastreie e indexe alterações de código
• Registro Automático de Chat: Registre interações de IA com captura aprimorada de contexto (diffs de código, sequências de ferramentas)
• Vinculação Bidirecional: Conecte discussões a alterações de código para rastrear a evolução de recursos
• Fragmentação Semântica de Código: Preserve estruturas lógicas de código para recuperação de contexto mais significativa
• Ferramentas de Memória de Trabalho: Comandos MCP para capturar e recuperar contexto de desenvolvimento
• Sistema de Validação: Validação baseada em evidências para alterações de código e promoções de aprendizado
• Aprendizado Automatizado Orientado a Testes: Fluxo de trabalho totalmente automatizado, desde falha de teste até correção verificada e promoção de aprendizado. Consulte o Guia de Uso do Plugin Pytest para integrar isso aos seus projetos.

Consulte o guia Começando com seu Segundo Cérebro para mais detalhes.

Início Rápido

Instalação

# Basic installation
pip install chroma-mcp-server

# Full installation with all embedding models
pip install "chroma-mcp-server[full]"

Execução

# With in-memory storage (data lost on restart)
chroma-mcp-server --client-type ephemeral

# With persistent storage
chroma-mcp-server --client-type persistent --data-dir ./my_data

Integração com Cursor

Adicione ou modifique .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "chroma": {
      "command": "uvx",
      "args": [
        "chroma-mcp-server"
      ],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/data",
        "CHROMA_LOG_DIR": "/path/to/your/logs",
        "LOG_LEVEL": "INFO",
        "MCP_LOG_LEVEL": "INFO",
        "MCP_SERVER_LOG_LEVEL": "INFO"
      }
    }
  }
}

Melhorias Recentes

• Captura Aprimorada de Contexto: Extrai automaticamente diffs de código, sequências de ferramentas e atribui pontuações de confiança
• Vinculação Bidirecional: Cria conexões navegáveis entre discussões de chat e alterações de código
• Fragmentação Semântica de Código: Usa limites lógicos (funções, classes) em vez de fragmentos de tamanho fixo
• Imposição de Carimbo de Data/Hora no Servidor: Garante carimbos de data/hora consistentes em todas as coleções
• Criação Automática de Coleções: Coleções essenciais (por exemplo, chat_history_v1, codebase_v1) são criadas automaticamente na inicialização do servidor se não existirem.
• Sistema de Registro Aprimorado: Arquivos de registro por execução evitam contaminação da comunicação JSON no modo stdio
• Gerenciamento de Funções de Embedding: Ferramentas para atualizar metadados de coleção ao alterar funções de embedding
• Comando de Configuração de Coleções: Simplifica a criação de múltiplas coleções com configuração consistente
• Fluxo de Trabalho de Promoção Automática: Promoção simplificada de aprendizado derivado com tratamento automático de entradas de alta confiança
• Padrões Inteligentes: Promoção interativa com padrões inteligentes para todos os campos com base no contexto
• Avisos de Baixa Confiança: Indicadores visuais para entradas que podem precisar de revisão mais cuidadosa
• Fluxo de Trabalho de Testes Automatizados: Captura totalmente automatizada de falhas de teste, monitoramento de correções e promoção validada de aprendizado

Documentação

Documentação abrangente está disponível no diretório docs:

• Documentação Principal - Guia completo de instalação, configuração e uso
• Começando - Instruções detalhadas de configuração
• Guia do Desenvolvedor - Para contribuidores e desenvolvedores
• Guias de Integração com IDE e Ferramentas - Guias para integração com IDEs e outras ferramentas.
• Registro Automático de Chat - Histórico de chat enriquecido com vinculação bidirecional
• Guias de Uso - Guias detalhados sobre como usar recursos e fluxos de trabalho específicos.
• Captura Aprimorada de Contexto - Detalhes sobre extração de diffs de código e sequenciamento de ferramentas
• Fragmentação Semântica de Código - Fragmentação de código que preserva a lógica para recuperação significativa
• Fluxo de Trabalho de Testes Automatizados (Uso do Plugin Pytest) - Aprendizado orientado a testes com validação automática
• Ferramentas e Utilitários de Pensamento - Documentação para ferramentas de pensamento estruturado e memória.
• Scripts de Cliente e Desenvolvedor - Guias para ferramentas CLI e scripts de desenvolvedor.
• Documentação de Registro - Visão geral dos recursos e configuração de registro.
• Registro do Servidor - Detalhes sobre o sistema de registro aprimorado
• Documentação de Automação - Guias sobre automação de tarefas de desenvolvimento.
• Regras e Diretrizes do Projeto - Regras de desenvolvimento, diretrizes e melhores práticas.
• Planos de Refatoração - Documentação sobre vários esforços de refatoração e planos arquiteturais.
• Referência da API - Ferramentas e parâmetros MCP disponíveis

Licença

O Servidor MCP Chroma é licenciado sob a Licença MIT com Cláusula Commons. Isso significa que você pode:

✅ Permitido:

• Usar o Servidor MCP Chroma para qualquer finalidade (pessoal, comercial, acadêmica)
• Modificar o código
• Distribuir cópias
• Criar e vender produtos construídos usando o Servidor MCP Chroma

❌ Não Permitido:

• Vender o próprio Servidor MCP Chroma
• Oferecer o Servidor MCP Chroma como serviço hospedado
• Criar produtos concorrentes baseados no Servidor MCP Chroma

Consulte o arquivo LICENSE.md para o texto completo da licença.