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 чтобы задать это место для безопасного хранения.