Chroma MCP

🚀 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 參數指定其位置，以確保安全。