Chroma MCP Server
Официальный MCP-сервер векторной базы Chroma: коллекции, документы, семантический и полнотекстовый поиск
Установка
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp",
"--client-type",
"persistent",
"--data-dir",
"/full/path/to/your/data/directory"
]
}Постоянная локальная база. Для Chroma Cloud укажите --client-type cloud с --tenant, --database и --api-key, для своего сервера --client-type http.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту работу с базой Chroma: создавать, менять и удалять коллекции, добавлять документы с метаданными, искать по смыслу, по тексту и с фильтрами по метаданным. Подключается к базе в памяти, к локальному каталогу на диске, к своему серверу Chroma по HTTP или к Chroma Cloud. При создании коллекции можно выбрать функцию эмбеддингов: встроенную или внешние от OpenAI, Cohere, Jina, VoyageAI и Roboflow. Выбранная функция сохраняется в настройках коллекции и используется дальше автоматически.
Для кого. Для разработчиков RAG и тех, кто хочет дать агенту долговременную память в векторной базе.
Подходит, если
- Нужно дать агенту память или базу знаний с поиском по смыслу
- Нужно посмотреть и отладить коллекции Chroma из чата
- Нужно быстро собрать прототип RAG на локальной базе
Не подходит, если
- Векторные данные уже живут в другой базе, например pgvector или Qdrant
- Коллекции созданы в Chroma 0.6.3 и старше: сохранение функции эмбеддингов не поддерживается
Пример запроса к агенту
Создай коллекцию meeting-notes и сохрани в нее эти заметки, потом найди все, что касается бюджетаОграничения
Для внешних функций эмбеддингов нужны ключи соответствующих сервисов, API OpenAI и часть других из России без VPN недоступны. Chroma Cloud требует аккаунт и ключ. С встроенными эмбеддингами и локальной базой внешние сервисы не нужны. Последние изменения в репозитории были около года назад.
Как отключить. Удалите блок chroma из конфигурации MCP клиента. Данные постоянного клиента останутся в указанном каталоге.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| CHROMA_CLIENT_TYPE | http, cloud, persistent или ephemeral |
| CHROMA_DATA_DIR | Каталог данных для постоянного клиента |
| CHROMA_API_KEY секрет | Ключ Chroma Cloud |
| CHROMA_TENANT | Тенант Chroma Cloud |
| CHROMA_DATABASE | Имя базы в Chroma Cloud |
| CHROMA_CUSTOM_AUTH_CREDENTIALS секрет | Учетные данные своего сервера Chroma |
Проверка безопасности
- Может удалять коллекции и документы
- При внешних эмбеддингах отправляет тексты сторонним API
Коротко о README
README перечисляет четыре типа клиента и полный список инструментов для коллекций и документов. Для Claude Desktop даны конфиги под каждый тип клиента с запуском через uvx. Описана настройка через переменные окружения и файл .chroma_env, включая ключи внешних функций эмбеддингов.
Частые вопросы
Где хранятся данные?
Зависит от типа клиента: ephemeral держит их в памяти до перезапуска, persistent пишет в каталог на диске, http и cloud хранят на сервере Chroma.
Как не держать ключи в аргументах?
Вынесите их в файл окружения и укажите путь через --dotenv-path, ключи внешних эмбеддингов задаются как CHROMA_<ИМЯ>_API_KEY.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения
Официальный MCP-сервер MongoDB: запросы и агрегации к базам, управление индексами, кластерами Atlas и локальными развертываниями