Chroma MCP Server

🚀 色度（Chroma）プロジェクト

色度 (Chroma) は、AI 開発ワークフローを支援するために、永続的で検索可能な「作業メモリ」を作成するツールです。このサーバーには、セッション間のコンテキストを管理するための埋め込み技術を利用した専用ツールが含まれています。

🚀 クイックスタート

色度（Chroma）を使い始めるには、まずインストールを行い、その後サーバーを起動します。以下に詳細な手順を説明します。

✨ 主な機能

• 持久化存储：データがセッション間で利用可能な状態を保ちます。
• 可扩展性：高い並行アクセスと大量データ処理をサポートします。
• 集成能力：様々なツールやサービスのワークフローと互換性があります。

📦 インストール

Hatch ツールを使用したインストール

hatch ツールを使用して Chroma プロジェクトをインストールするには、以下のコマンドを実行してください。

pip install hatch
cd path/to/chroma-project
hatch install --dev

詳細な情報は Hatch ドキュメント を参照してください。

Uv ツールを使用したインストール

uv ツールを使用して PyPI から Chroma プロジェクトをインストールするには、以下のコマンドを実行してください。

uvx install chroma-mcp-server

詳細な情報は Uv ドキュメント を参照してください。

💻 使用例

サーバーの起動

Chroma サーバーを起動するには、以下のコマンドを使用してください。

hatch run chroma-mcp-server start -- --config path/to/config.yaml

または、PyPI から直接インストールしたバージョンを実行することもできます。

chroma-mcp-server start -- --config path/to/config.yaml

詳細な情報は クイックスタートガイド を参照してください。

他のツールとの統合

与 Cursor の統合

プロジェクトに Chroma を統合するには、プロジェクトのルートディレクトリに .cursor/mcp.json ファイルを作成または編集します。以下は設定例です。

{
  "mcpServers": {
    "chroma_dev": {
      "command": "/path/to/project/scripts/run_chroma_mcp_server_dev.sh",
      "args": [],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/dev_data",
        "CHROMA_LOG_DIR": "/path/to/your/dev_logs",
        "LOG_LEVEL": "DEBUG",
        "MCP_LOG_LEVEL": "DEBUG"
      }
    },
    "chroma_test": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--default-index", "https://test.pypi.org/simple/",
        "--index", "https://pypi.org/simple/",
        "--index-strategy", "unsafe-best-match",
        "chroma-mcp-server@latest"
      ],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/test_data",
        "CHROMA_LOG_DIR": "/path/to/your/test_logs",
        "LOG_LEVEL": "INFO",
        "MCP_LOG_LEVEL": "INFO"
      }
    },
    "chroma_prod": {
      "command": "uvx",
      "args": [
        "chroma-mcp-server"
      ],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/prod_data",
        "CHROMA_LOG_DIR": "/path/to/your/prod_logs",
        "LOG_LEVEL": "INFO",
        "MCP_LOG_LEVEL": "INFO"
      }
    }
  }
}

詳細な情報は 統合ガイド を参照してください。

📚 ドキュメント

開発フロー

開発に参加するには、以下のコマンドを実行してください。

git clone git@github.com:your-username/chroma-project.git
cd chroma-project
pip install -r requirements/development.txt
hatch run pytest tests/

詳細な情報は 開発者ドキュメント を参照してください。

プロジェクトの背景

動機

AI 開発ワークフローにおける課題に対応するために、Chroma を開発しました。最新のストレージ技術と分散システム設計を組み合わせることで、Chroma は大規模データを効率的に管理することができます。

詳細な情報は 設計ドキュメント を参照してください。

🔗 関連リンク

• プロジェクトリポジトリ: https://github.com/your-username/chroma-project
• オンラインドキュメント: https://your-docs-site.chroma-project.org

🤝 コントリビューションガイド

コミュニティからの貢献を歓迎します！開発に参加する方法については、開発者ドキュメント を参照してください。

⚠️ 重要提示

このドキュメントはサンプルです。実際のプロジェクトでは、具体的なニーズに合わせて調整する必要があります。