Chroma MCP Server
Официальный MCP-сервер векторной базы Chroma: коллекции, документы, семантический и полнотекстовый поиск
- 600 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Может удалять коллекции и документы
- При внешних эмбеддингах отправляет тексты сторонним API
Установка
- Работает в
Ручная установка
"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.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Может удалять коллекции и документы
- При внешних эмбеддингах отправляет тексты сторонним API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту работу с базой Chroma: создавать, менять и удалять коллекции, добавлять документы с метаданными, искать по смыслу, по тексту и с фильтрами по метаданным. Подключается к базе в памяти, к локальному каталогу на диске, к своему серверу Chroma по HTTP или к Chroma Cloud. При создании коллекции можно выбрать функцию эмбеддингов: встроенную или внешние от OpenAI, Cohere, Jina, VoyageAI и Roboflow. Выбранная функция сохраняется в настройках коллекции и используется дальше автоматически.
Для кого. Для разработчиков RAG и тех, кто хочет дать агенту долговременную память в векторной базе.
Подходит, если
- Нужно дать агенту память или базу знаний с поиском по смыслу
- Нужно посмотреть и отладить коллекции Chroma из чата
- Нужно быстро собрать прототип RAG на локальной базе
Не подходит, если
- Векторные данные уже живут в другой базе, например pgvector или Qdrant
- Коллекции созданы в Chroma 0.6.3 и старше: сохранение функции эмбеддингов не поддерживается
Пример запроса к агенту
Создай коллекцию meeting-notes и сохрани в нее эти заметки, потом найди все, что касается бюджета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 OpenAI и часть других из России без VPN недоступны. Chroma Cloud требует аккаунт и ключ. С встроенными эмбеддингами и локальной базой внешние сервисы не нужны. Последние изменения в репозитории были около года назад.
Как отключить. Удалите блок chroma из конфигурации MCP клиента. Данные постоянного клиента останутся в указанном каталоге.
Частые вопросы
Где хранятся данные?
Зависит от типа клиента: ephemeral держит их в памяти до перезапуска, persistent пишет в каталог на диске, http и cloud хранят на сервере Chroma.
Как не держать ключи в аргументах?
Вынесите их в файл окружения и укажите путь через --dotenv-path, ключи внешних эмбеддингов задаются как CHROMA_<ИМЯ>_API_KEY.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
Официальный MCP-сервер Pinecone: поиск по документации, создание индексов, загрузка и поиск записей прямо из агента
MCP-сервер для Milvus
MCP Server for Milvus
Официальный MCP-сервер Zilliz: агент ищет по векторам и тексту, управляет коллекциями и данными в Milvus
Официальный MCP-сервер Redis: строки, хеши, стримы, JSON и векторный поиск через агента
Набор MCP-серверов Neo4j Labs: Cypher-запросы к графу, графовая память агента, управление Aura и моделирование данных
Официальный MCP-сервер MongoDB: запросы и агрегации к базам, управление индексами, кластерами Atlas и локальными развертываниями
Коротко о README
README перечисляет четыре типа клиента и полный список инструментов для коллекций и документов. Для Claude Desktop даны конфиги под каждый тип клиента с запуском через uvx. Описана настройка через переменные окружения и файл .chroma_env, включая ключи внешних функций эмбеддингов.