🚀 Chroma MCP 服务器
Chroma 是一个开源的嵌入式数据库，借助它，开发者能够快速构建具备上下文感知功能的大型语言模型（LLM）应用程序。集成 Chroma 后，可为应用轻松增添记忆和知识库功能。
🚀 快速开始
安装与配置
在 claude_desktop_config.json 文件中添加如下配置，即可启用 Chroma 客户端。
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp"
]
}
客户端配置类型
持久化客户端
若希望数据在应用重启后仍然保留，可以配置为持久化客户端。
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp",
"--client-type",
"persistent",
"--data-dir",
"/full/path/to/your/data/directory"
]
}
云端客户端
连接到 Chroma 云服务。
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp",
"--client-type",
"cloud",
"--tenant",
"your-tenant-id",
"--database",
"your-database-name",
"--api-key",
"your-api-key"
]
}
自托管客户端
连接到你自己搭建的 Chroma 实例。
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp",
"--client-type",
"http",
"--host",
"your-host",
"--port",
"your-port",
"--custom-auth-credentials",
"your-custom-auth-credentials",
"--ssl",
"true"
]
}
📚 详细文档
环境变量配置
你也可以通过环境变量来配置 Chroma 客户端。服务器会自动加载指定路径下的 .env 文件或系统环境变量，命令行参数优先级最高。
常用环境变量
# 设置客户端类型
export CHROMA_CLIENT_TYPE="http" # 或者 "cloud", "persistent", "ephemeral"
# 持久化客户端配置
export CHROMA_DATA_DIR="/full/path/to/your/data/directory"
# 云端客户端配置
export CHROMA_TENANT="your-tenant-id"
export CHROMA_DATABASE="your-database-name"
export CHROMA_API_KEY="your-api-key"
# 自托管客户端配置
export CHROMA_HOST="your-host"
export CHROMA_PORT="your-port"
export CHROMA_CUSTOM_AUTH_CREDENTIALS="your-custom-auth-credentials"
export CHROMA_SSL="true"
# 指定 .env 文件路径（默认为当前目录的 .chroma_env）
export CHROMA_DOTENV_PATH="/path/to/your/.env"
嵌入式函数 API 密钥
对于需要访问外部 API 的嵌入式函数，使用环境变量命名规则 CHROMA_<服务名称>_API_KEY。例如：
- Cohere API 密钥：设置为
CHROMA_COHERE_API_KEY="your-key" - OpenAI API 密钥：设置为
CHROMA_OPENAI_API_KEY="your-key"
⚠️ 重要提示
建议将这些敏感信息存放在单独的
.env文件中，并通过--dotenv-path参数指定其位置，以确保安全。