Chroma MCP Server

Chroma MCP Server

Das Model Context Protocol (MCP) ist ein offenes Protokoll, das für die mühelose Integration zwischen LLM-Anwendungen und externen Datenquellen oder Tools entwickelt wurde und ein standardisiertes Framework bietet, um LLMs nahtlos mit dem Kontext zu versorgen, den sie benötigen.

Dieser Server bietet Datenabruffunktionen auf Basis von Chroma, sodass KI-Modelle Sammlungen aus generierten Daten und Benutzereingaben erstellen und diese Daten mithilfe von Vektorsuche, Volltextsuche, Metadatenfilterung und mehr abrufen können.

Merkmale

• Flexible Clienttypen
  • Flüchtig (im Arbeitsspeicher) für Tests und Entwicklung
  • Persistent für dateibasierte Speicherung
  • HTTP-Client für selbstgehostete Chroma-Instanzen
  • Cloud-Client für die Chroma Cloud-Integration (verbindet sich automatisch mit api.trychroma.com)
• Sammlungsverwaltung
  • Sammlungen erstellen, ändern und löschen
  • Alle Sammlungen mit Paginierungsunterstützung auflisten
  • Erhalten Sie Sammlungsinformationen und Statistiken
  • Konfigurieren Sie HNSW-Parameter für eine optimierte Vektorsuche
  • Einbettungsfunktionen beim Erstellen von Sammlungen auswählen
• Dokumentvorgänge
  • Fügen Sie Dokumente mit optionalen Metadaten und benutzerdefinierten IDs hinzu
  • Abfragen von Dokumenten mithilfe der semantischen Suche
  • Erweiterte Filterung anhand von Metadaten und Dokumentinhalten
  • Abrufen von Dokumenten anhand von IDs oder Filtern
  • Volltextsuchfunktionen

Unterstützte Tools

• chroma_list_collections – Alle Sammlungen mit Paginierungsunterstützung auflisten
• chroma_create_collection – Erstellen Sie eine neue Sammlung mit optionaler HNSW-Konfiguration
• chroma_peek_collection – Eine Auswahl von Dokumenten in einer Sammlung anzeigen
• chroma_get_collection_info - Detaillierte Informationen zu einer Sammlung abrufen
• chroma_get_collection_count - Anzahl der Dokumente in einer Sammlung ermitteln
• chroma_modify_collection – Aktualisieren Sie den Namen oder die Metadaten einer Sammlung
• chroma_delete_collection – Eine Sammlung löschen
• chroma_add_documents - Dokumente mit optionalen Metadaten und benutzerdefinierten IDs hinzufügen
• chroma_query_documents – Abfragen von Dokumenten mithilfe der semantischen Suche mit erweiterter Filterung
• chroma_get_documents - Dokumente nach IDs oder Filtern mit Seitennummerierung abrufen
• chroma_update_documents – Inhalte, Metadaten oder Einbettungen vorhandener Dokumente aktualisieren
• chroma_delete_documents – Löschen Sie bestimmte Dokumente aus einer Sammlung

Einbettungsfunktionen

Chroma MCP unterstützt mehrere Einbettungsfunktionen: default , cohere , openai , jina , voyageai und roboflow .

Die Einbettungsfunktionen nutzen die Sammlungskonfiguration von Chroma, die die ausgewählte Einbettungsfunktion einer Sammlung für den Abruf speichert. Sobald eine Sammlung mithilfe der Sammlungskonfiguration erstellt wurde, wird beim Abrufen für zukünftige Abfragen und Einfügungen dieselbe Einbettungsfunktion verwendet, ohne dass die Einbettungsfunktion erneut angegeben werden muss. Die Persistenz der Einbettungsfunktion wurde in Chroma v1.0.0 hinzugefügt. Wenn Sie eine Sammlung mit Version <=0.6.3 erstellt haben, wird diese Funktion daher nicht unterstützt.

Wenn Sie auf Einbettungsfunktionen zugreifen, die externe APIs verwenden, achten Sie darauf, die Umgebungsvariable für den API-Schlüssel im richtigen Format hinzuzufügen. Diese finden Sie unter Umgebungsvariablen für Einbettungsfunktionen.

Verwendung mit Claude Desktop

1. Um einen kurzlebigen Client hinzuzufügen, fügen Sie Ihrer Datei claude_desktop_config.json Folgendes hinzu:

2. Um einen persistenten Client hinzuzufügen, fügen Sie Ihrer Datei claude_desktop_config.json Folgendes hinzu:

Dadurch wird ein persistenter Client erstellt, der das angegebene Datenverzeichnis verwendet.

3. Um eine Verbindung mit Chroma Cloud herzustellen, fügen Sie Ihrer Datei claude_desktop_config.json Folgendes hinzu:

Dadurch wird ein Cloud-Client erstellt, der automatisch über SSL eine Verbindung zu api.trychroma.com herstellt.

Hinweis: Das Hinzufügen von API-Schlüsseln in Argumenten ist auf lokalen Geräten problemlos möglich. Aus Sicherheitsgründen können Sie jedoch auch einen benutzerdefinierten Pfad für Ihre Umgebungskonfigurationsdatei angeben, indem Sie das Argument --dotenv-path in der args verwenden, zum Beispiel: "args": ["chroma-mcp", "--dotenv-path", "/custom/path/.env"] .

4. Um eine Verbindung zu einer [selbst gehosteten Chroma-Instanz bei Ihrem eigenen Cloud-Anbieter] ( https://docs.trychroma.com/production/deployment ) herzustellen, fügen Sie Ihrer Datei claude_desktop_config.json Folgendes hinzu:

Dadurch wird ein HTTP-Client erstellt, der eine Verbindung zu Ihrer selbst gehosteten Chroma-Instanz herstellt.

Demos

Finden Sie Referenzverwendungen, wie z. B. gemeinsame Wissensdatenbanken und das Hinzufügen von Speicher zu Kontextfenstern in denChroma MCP-Dokumenten

Verwenden von Umgebungsvariablen

Sie können den Client auch mithilfe von Umgebungsvariablen konfigurieren. Der Server lädt automatisch Variablen aus einer .env Datei im durch --dotenv-path angegebenen Pfad (standardmäßig .chroma_env im Arbeitsverzeichnis) oder aus Systemumgebungsvariablen. Kommandozeilenargumente haben Vorrang vor Umgebungsvariablen.

Einbetten von Funktionsumgebungsvariablen

Wenn Sie externe Einbettungsfunktionen verwenden, die auf einen API-Schlüssel zugreifen, befolgen Sie die Namenskonvention CHROMA_<>_API_KEY="<key>" . Um einen Cohere-API-Schlüssel festzulegen, setzen Sie die Umgebungsvariable CHROMA_COHERE_API_KEY="" . Wir empfehlen, diese irgendwo in eine .env-Datei einzufügen und die Umgebungsvariable CHROMA_DOTENV_PATH oder das Flag --dotenv-path zu verwenden, um diesen Speicherort zur sicheren Aufbewahrung festzulegen.