JinDaGe - chroma-mcp MCP Details

article

README

🚀 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 参数指定其位置，以确保安全。

chroma-mcp