Chroma MCP

Добавляет документы в коллекцию Chroma. Аргументы: collection_name: Имя коллекции, в которую добавляются документы documents: Список текстовых документов для добавления ids: Список идентификаторов для документов (обязательно) metadatas: Необязательный список словарей метаданных для каждого документа

Создаёт новую коллекцию Chroma с настраиваемыми параметрами HNSW. Аргументы: collection_name: название создаваемой коллекции embedding_function_name: название используемой функции эмбеддинга. Варианты: 'default', 'cohere', 'openai', 'jina', 'voyageai', 'ollama', 'roboflow' metadata: необязательный словарь метаданных для добавления в коллекцию

Удаляет коллекцию Chroma. Аргументы: collection_name: Имя коллекции для удаления

Удаляет документы из коллекции Chroma. Аргументы: collection_name: имя коллекции, из которой нужно удалить документы ids: список идентификаторов документов для удаления Возвращает: Сообщение о подтверждении с указанием количества удаленных документов. Исключения: ValueError: если 'ids' пуст Exception: если коллекция не существует или операция удаления не удалась.

Создаёт копию коллекции Chroma. Аргументы: collection_name: имя коллекции new_collection_name: имя новой коллекции metadata: необязательный словарь метаданных для добавления в новую коллекцию

Получает количество документов в коллекции Chroma. Аргументы: collection_name: имя коллекции для подсчёта

Получает информацию о коллекции Chroma. Аргументы: collection_name: название коллекции, о которой нужно получить информацию

Получает документы из коллекции Chroma с необязательной фильтрацией. Аргументы: - collection_name: Имя коллекции, из которой получаются документы - ids: Необязательный список идентификаторов документов для получения - where: Необязательные фильтры метаданных с использованием операторов запросов Chroma Примеры: - Простое равенство: {"metadata_field": "value"} - Сравнение: {"metadata_field": {"$gt": 5}} - Логическое И: {"$and": [{"field1": {"$eq": "value1"}}, {"field2": {"$gt": 5}}]} - Логическое ИЛИ: {"$or": [{"field1": {"$eq": "value1"}}, {"field1": {"$eq": "value2"}}]} - where_document: Необязательные фильтры содержимого документов Примеры: - Содержит: {"$contains": "value"} - Не содержит: {"$not_contains": "value"} - Regex: {"$regex": "[a-z]+"} - Not regex: {"$not_regex": "[a-z]+"} - Логическое И: {"$and": [{"$contains": "value1"}, {"$not_regex": "[a-z]+"}]} - Логическое ИЛИ: {"$or": [{"$regex": "[a-z]+"}, {"$not_contains": "value2"}]} - include: Список того, что включить в ответ. По умолчанию включает документы и метаданные. - limit: Необязательное максимальное количество документов для возврата - offset: Необязательное количество документов, которые нужно пропустить перед возвратом результатов Возвращает: Словарь, содержащий соответствующие документы, их идентификаторы и запрошенные включения.

Below is a Python implementation that satisfies the requirements. It assumes the function is a method of a class that has a Chroma client stored as self._client. The function fetches all collections, sorts them, applies pagination, and returns the appropriate list. python from typing import List, Optional def list_collections(self, limit: Optional[int] = None, offset: Optional[int] = None) -> List[str]: """ List all collection names in the Chroma database with pagination support. Args: limit: Optional maximum number of collections to return offset: Optional number of collections to skip before returning results Returns: List of collection names or ["__NO_COLLECTIONS_FOUND__"] if database is empty """ # Fetch all collections from Chroma collections = self._client.list_collections() # Extract and sort names for deterministic output names = sorted([col.name for col in collections]) # If the database is empty, return the sentinel value if not names: return ["__NO_COLLECTIONS_FOUND__"] # Apply pagination if offset is not None: names = names[offset:] if limit is not None: names = names[:limit] return names Key points: - The function retrieves all collection names, sorts them alphabetically. - It returns the sentinel list ["__NO_COLLECTIONS_FOUND__"] only when the database is completely empty. - Pagination is applied after sorting, and limit/offset work as expected (e.g., offset=2, limit=3 skips the first two and returns the next three). - If offset is beyond the number of collections, an empty list is returned (since the database is not empty, just the range is out of bounds).

Изменяет имя или метаданные коллекции Chroma. Аргументы: collection_name: Название коллекции для изменения new_name: Необязательное новое название коллекции new_metadata: Необязательные новые метаданные коллекции

Просматривает документы в коллекции Chroma. Аргументы: collection_name: Название коллекции для просмотра limit: Количество документов для просмотра

Запрашивает документы из коллекции Chroma с расширенной фильтрацией. Аргументы: collection_name: Название коллекции для запроса query_texts: Список текстов запроса для поиска n_results: Количество результатов для возврата на один запрос where: Необязательные фильтры метаданных с использованием операторов запроса Chroma Примеры: - Простое равенство: {"metadata_field": "value"} - Сравнение: {"metadata_field": {"$gt": 5}} - Логическое И: {"$and": [{"field1": {"$eq": "value1"}}, {"field2": {"$gt": 5}}]} - Логическое ИЛИ: {"$or": [{"field1": {"$eq": "value1"}}, {"field1": {"$eq": "value2"}}]} where_document: Необязательные фильтры содержимого документов Примеры: - Содержит: {"$contains": "value"} - Не содержит: {"$not_contains": "value"} - Регулярное выражение: {"$regex": "[a-z]+"} - Не регулярное выражение: {"$not_regex": "[a-z]+"} - Логическое И: {"$and": [{"$contains": "value1"}, {"$not_regex": "[a-z]+"}]} - Логическое ИЛИ: {"$or": [{"$regex": "[a-z]+"}, {"$not_contains": "value2"}]} include: Список того, что включить в ответ. По умолчанию включает документы, метаданные и расстояния.

Обновляет документы в коллекции Chroma. Аргументы: collection_name: Имя коллекции, в которой обновляются документы ids: Список идентификаторов документов для обновления (обязательно) embeddings: Необязательный список новых эмбеддингов для документов. Должен совпадать по длине с ids, если указан. metadatas: Необязательный список новых словарей метаданных для документов. Должен совпадать по длине с ids, если указан. documents: Необязательный список новых текстовых документов. Должен совпадать по длине с ids, если указан. Возвращает: Сообщение о подтверждении с указанием количества обновлённых документов. Исключения: ValueError: Если 'ids' пуст, или не указан ни один из 'embeddings', 'metadatas' или 'documents', или длина предоставленных списков обновления не совпадает с длиной 'ids'. Исключение: Если коллекция не существует или операция обновления завершилась ошибкой.