适合谁
- 需要与 Claude 等 MCP 兼容客户端集成的向量数据库场景。
- 希望自托管 Chroma 并统一 API 的开发者和团队。
- 需要持久化或云托管向量存储的 AI 应用。
C
48FMRS · D
该服务端由 Chroma 团队官方维护，功能完整，集成方便。适合需要为 AI 应用添加向量记忆的开发者。但需要注意外部 API 和数据安全风险。
这是一个基于 Chroma 开源嵌入数据库的 MCP 服务端实现。它允许 AI 模型（如 LLM）通过标准化的模型上下文协议与 Chroma 交互，实现数据的存储、语义搜索和检索。支持临时（内存）、持久化、HTTP 自托管和云（Chroma Cloud）多种客户端类型，并提供集合管理、文档操作、向量搜索、全文搜索等功能。
工具能力
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
添加文档，可附带元数据和自定义 ID。
chroma_query_documents
使用语义搜索查询文档，支持高级过滤。
chroma_get_documents
按 ID 或过滤条件检索文档，支持分页。
chroma_update_documents
更新现有文档的内容、元数据或嵌入向量。
chroma_delete_documents
从集合中删除特定文档。
安装接入
- 安装 Python 和 uv（或 pip）。
- 在 Claude Desktop 配置文件中添加 MCP 服务器配置，使用 uvx 运行 chroma-mcp。
- 根据需要配置客户端类型（默认临时，可通过参数切换为持久化、HTTP 或云）。
claude_desktop_config.json
{
"mcpServers": {
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp"
]
}
}
}
选型与风险
不适合谁
- 不适用于非向量数据库场景。
- 不适用于需要关系型查询或复杂事务的应用。
- 不适合对数据隐私要求极高且不能接受外部 API 调用的场景（使用外部嵌入函数时）。
所需权限
- 文件系统访问（持久化客户端）用于存储数据。
- 网络访问（HTTP 或云客户端）用于连接远程 Chroma 实例或外部嵌入 API。
- 环境变量或配置文件中的 API 密钥（如 Cohere、OpenAI 等）用于调用外部嵌入模型。
风险与副作用
- 外部嵌入 API 可能导致数据发送到第三方服务，存在数据泄露风险。
- 自托管 HTTP 客户端若未正确配置认证，可能暴露敏感数据。
- 持久化客户端需要确保数据目录的写权限和备份。
常见排障
- 确保已安装 uv 或正确设置 Python 环境。
- 检查 .env 文件或环境变量是否正确设置，特别是 API 密钥。
- 对于 HTTP 客户端，确认主机、端口和 SSL 配置正确，且服务可访问。
- 若使用持久化客户端，检查数据目录是否存在且可写。
使用场景
为 LLM 应用添加长期记忆，存储和检索对话历史或知识库。
构建语义搜索功能，实现基于向量相似度的文档检索。
在开发环境中快速测试向量数据库功能，使用内存模式无需额外部署。
支持客户端
Claude Desktop完整支持