Chroma MCP Server

Сервер Chroma MCP

Протокол контекста модели (MCP) — это открытый протокол, разработанный для легкой интеграции между приложениями LLM и внешними источниками данных или инструментами, предлагающий стандартизированную структуру для беспрепятственного предоставления LLM необходимого им контекста.

Этот сервер предоставляет возможности извлечения данных на основе Chroma, позволяя моделям ИИ создавать коллекции на основе сгенерированных данных и вводимых пользователем данных, а также извлекать эти данные с помощью векторного поиска, полнотекстового поиска, фильтрации метаданных и многого другого.

Функции

• Гибкие типы клиентов
  • Эфемерный (в памяти) для тестирования и разработки
  • Постоянный для файлового хранения
  • HTTP-клиент для самостоятельно размещенных экземпляров Chroma
  • Облачный клиент для интеграции Chroma Cloud (автоматически подключается к api.trychroma.com)
• Управление коллекциями
  • Создание, изменение и удаление коллекций
  • Список всех коллекций с поддержкой пагинации
  • Получить информацию о сборе и статистику
  • Настройте параметры HNSW для оптимизированного поиска векторов
  • Выбирайте функции встраивания при создании коллекций
• Операции с документами
  • Добавляйте документы с дополнительными метаданными и пользовательскими идентификаторами.
  • Запрос документов с использованием семантического поиска
  • Расширенная фильтрация с использованием метаданных и содержимого документа
  • Извлечение документов по идентификаторам или фильтрам
  • Возможности полнотекстового поиска

Поддерживаемые инструменты

• chroma_list_collections — список всех коллекций с поддержкой пагинации
• chroma_create_collection — создание новой коллекции с дополнительной конфигурацией HNSW
• chroma_peek_collection — просмотр выборки документов в коллекции
• chroma_get_collection_info - Получить подробную информацию о коллекции
• chroma_get_collection_count — Получить количество документов в коллекции
• chroma_modify_collection — обновить название коллекции или метаданные
• chroma_delete_collection — Удалить коллекцию
• chroma_add_documents — добавление документов с дополнительными метаданными и пользовательскими идентификаторами
• chroma_query_documents — Запрос документов с использованием семантического поиска с расширенной фильтрацией
• chroma_get_documents — Извлечение документов по идентификаторам или фильтрам с разбивкой на страницы
• chroma_update_documents — обновление содержимого, метаданных или вложений существующих документов
• chroma_delete_documents — удаление определенных документов из коллекции

Встраивание функций

Chroma MCP поддерживает несколько функций встраивания: default , cohere , openai , jina , voyageai и roboflow .

Функции встраивания используют конфигурацию коллекции Chroma, которая сохраняет выбранную функцию встраивания коллекции для извлечения. После создания коллекции с использованием конфигурации коллекции при извлечении для будущих запросов и вставок будет использоваться та же функция встраивания, без необходимости указывать функцию встраивания снова. Сохранение функции встраивания было добавлено в версии 1.0.0 Chroma, поэтому если вы создали коллекцию с использованием версии <=0.6.3, эта функция не поддерживается.

При доступе к функциям встраивания, использующим внешние API, обязательно добавьте переменную среды для ключа API в правильном формате, см. раздел Переменные среды функций встраивания.

Использование с Claude Desktop

1. Чтобы добавить временного клиента, добавьте в файл claude_desktop_config.json следующее:

2. Чтобы добавить постоянного клиента, добавьте в файл claude_desktop_config.json следующее:

Это создаст постоянный клиент, который будет использовать указанный каталог данных.

3. Чтобы подключиться к Chroma Cloud, добавьте в файл claude_desktop_config.json следующее:

Это создаст облачный клиент, который автоматически подключится к api.trychroma.com с помощью SSL.

Примечание: Добавление ключей API в аргументы допустимо на локальных устройствах, но в целях безопасности вы также можете указать пользовательский путь для файла конфигурации среды с помощью аргумента --dotenv-path в списке args , например: "args": ["chroma-mcp", "--dotenv-path", "/custom/path/.env"] .

4. Чтобы подключиться к [самостоятельно размещенному экземпляру Chroma у вашего собственного облачного провайдера] ( https://docs.trychroma.com/production/deployment ), добавьте в файл claude_desktop_config.json следующее:

Это создаст HTTP-клиент, который подключится к вашему размещенному экземпляру Chroma.

Демо-версии

Найдите справочные примеры использования, такие как общие базы знаний и добавление памяти в контекстные окна вдокументации Chroma MCP.

Использование переменных среды

Вы также можете использовать переменные окружения для настройки клиента. Сервер автоматически загрузит переменные из файла .env , расположенного по пути, указанному параметром --dotenv-path (по умолчанию .chroma_env в рабочем каталоге), или из системных переменных окружения. Аргументы командной строки имеют приоритет над переменными окружения.

Переменные окружения встраиваемых функций

При использовании внешних функций встраивания, которые обращаются к ключу API, следуйте соглашению об именовании CHROMA_<>_API_KEY="<key>" . Таким образом, чтобы задать ключ API Cohere, установите переменную среды CHROMA_COHERE_API_KEY="" . Мы рекомендуем добавить это в файл .env где-нибудь и использовать переменную среды CHROMA_DOTENV_PATH или флаг --dotenv-path чтобы задать это место для безопасного хранения.