Chroma MCP

🚀 Chroma MCP サーバ

Chromaは、開発者がコンテキスト感知機能を持つ大規模言語モデル（LLM）アプリケーションを迅速に構築できるようにするためのオープンソースの組み込みデータベースです。Chromaを統合することで、アプリに記憶機能と知識ベース機能を簡単に追加できます。

🚀 クイックスタート

💻 使用例

基本的な使用法

以下は、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 引数でその位置を指定することをおすすめします。これにより、セキュリティを確保できます。