Chroma MCP 服务器

概述

Chroma 是一个开源的嵌入式数据库，旨在帮助开发者快速构建具有上下文感知功能的大型语言模型（LLM）应用程序。通过集成 Chroma，你可以轻松地为你的应用添加记忆和知识库功能。

以下是一个使用示例：

1. 安装与配置：在 claude_desktop_config.json 文件中添加如下配置，即可启用 Chroma 客户端。

   "chroma": {
       "command": "uvx",
       "args": [
           "chroma-mcp"
       ]
   }
   

2. 持久化客户端：若希望数据在应用重启后仍然保留，可以配置为持久化客户端。

   "chroma": {
       "command": "uvx",
       "args": [
           "chroma-mcp", 
           "--client-type", 
           "persistent", 
           "--data-dir", 
           "/full/path/to/your/data/directory"
       ]
   }
   

3. 云端客户端：连接到 Chroma 云服务。

   "chroma": {
       "command": "uvx",
       "args": [
           "chroma-mcp", 
           "--client-type", 
           "cloud", 
           "--tenant", 
           "your-tenant-id", 
           "--database", 
           "your-database-name", 
           "--api-key", 
           "your-api-key"
       ]
   }
   

4. 自托管客户端：连接到你自己搭建的 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 参数指定其位置，以确保安全。