Integração do Servidor MCP Chroma

O que faz o Servidor MCP “Chroma”?

O Servidor MCP Chroma é uma implementação do Model Context Protocol (MCP) que equipa assistentes de IA com robustos recursos de banco de dados através do banco de dados vetorial Chroma. Ele permite integração perfeita com fontes de dados externas, permitindo que modelos de IA criem, gerenciem e consultem coleções de documentos. Com recursos como busca textual e semântica, filtragem por metadados e opções flexíveis de armazenamento (efêmero, persistente, HTTP e nuvem), o servidor permite que desenvolvedores aprimorem seus fluxos de trabalho fornecendo às LLMs ferramentas eficientes de recuperação e gestão de dados. Isso capacita aplicações de IA a realizar operações avançadas como gestão de coleções e consulta de documentos, apoiando tarefas como recuperação de informações, gestão do conhecimento e muito mais dentro de fluxos de desenvolvimento.

Lista de Prompts

Nenhum template de prompt é mencionado no repositório.

Lista de Recursos

Nenhum recurso explícito é detalhado na documentação do repositório.

Lista de Ferramentas

• chroma_list_collections – Lista todas as coleções com suporte a paginação.
• chroma_create_collection – Cria uma nova coleção com configuração HNSW opcional.
• chroma_peek_collection – Visualiza uma amostra de documentos de uma coleção.
• chroma_get_collection_info – Obtém informações detalhadas sobre uma coleção.
• chroma_get_collection_count – Obtém o número de documentos em uma coleção.
• chroma_modify_collection – Atualiza o nome ou os metadados de uma coleção.
• chroma_delete_collection – Exclui uma coleção.
• chroma_add_documents – Adiciona documentos com metadados e IDs personalizados opcionais.
• chroma_query_documents – Consulta documentos usando busca semântica com filtragem avançada.

Casos de Uso deste Servidor MCP

• Gestão de Banco de Dados
  Crie, modifique e exclua coleções facilmente para organizar dados de projetos ou aplicações orientadas por IA.
• Busca Semântica e Textual
  Realize recuperação avançada de documentos utilizando buscas semânticas e por texto, ideal para aplicações que exigem recuperação de conhecimento contextualizada.
• Filtragem por Metadados
  Recupere e filtre documentos usando campos de metadados personalizados, apoiando fluxos de trabalho personalizados e categorização de dados.
• Ingestão & Recuperação de Documentos
  Adicione e recupere documentos de maneira eficiente (com metadados e IDs), facilitando a construção de bases de conhecimento e conjuntos de treinamento de IA.
• Análises de Coleções
  Acesse estatísticas de coleções e contagem de documentos para monitorar e otimizar estratégias de armazenamento e recuperação de dados.

Como configurar

Windsurf

1. Certifique-se de que Node.js e npm estão instalados.
2. Abra as configurações ou diretório de configuração do seu projeto Windsurf.
3. Edite o arquivo de configuração para adicionar o Servidor MCP Chroma.
4. Insira o seguinte trecho JSON em mcpServers:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

5. Salve o arquivo e reinicie o Windsurf.
6. Verifique se o servidor está em execução consultando os logs ou o painel do servidor MCP.

Protegendo chaves de API

Utilize variáveis de ambiente para chaves sensíveis:

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Claude

1. Instale o Node.js, caso ainda não esteja presente.
2. Abra o arquivo de configuração do Claude.
3. Adicione o seguinte em mcpServers:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Salve e reinicie o Claude.
5. Confira os logs do sistema para registro do servidor com sucesso.

Protegendo chaves de API

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cursor

1. Pré-requisito: Node.js instalado.
2. Abra o arquivo de configurações do Cursor.
3. Insira a configuração do Servidor MCP Chroma:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Salve e reinicie o Cursor.
5. Valide a conexão pelo painel de extensões do Cursor.

Protegendo chaves de API

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cline

1. Certifique-se de que o Node.js está instalado.
2. Acesse o arquivo de configuração do Cline.
3. Adicione o Servidor MCP Chroma:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Salve as alterações e reinicie a aplicação.
5. Confirme se o servidor MCP aparece na interface do Cline.

Protegendo chaves de API

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP utilizando este formato JSON:

{
  "chroma-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparamcp/url"
  }
}

Uma vez configurado, o agente de IA poderá utilizar esse MCP como ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de trocar “chroma-mcp” pelo nome real do seu servidor MCP e substituir a URL pela do seu MCP.

Visão Geral

Eu daria a este servidor MCP uma nota 6/10. Ele é robusto em ferramentas de banco de dados e configuração, mas carece de documentação clara sobre prompts, recursos e recursos avançados de MCP como roots e amostragem.

Pontuação MCP