Hologres:Code Context Hologres ユーザーガイド

環境要件

DashScope と Bailian の設定

埋め込みモデルを使用するには、DashScope API キーが必要です。

1. Alibaba Cloud アカウントにサインアップします。

2. Model Studio (Bailian) サービスを有効化します。

3. Model Studio (Bailian) コンソールで API キーを作成します。キーは sk- で始まります。

利用可能な DashScope 埋め込みモデル：

Hologres インスタンスの設定

ベクトルデータを保存するには、Hologres インスタンスが必要です。次の接続詳細に注意してください：

AI コーディングアシスタントのインストール

使用している AI コーディングアシスタントのインストール手順に従ってください：

• Qwen Code：公式の Qwen Code ドキュメントを参照して、インストールを完了してください。

• Claude Code：Claude Code ドキュメントを参照して、インストールを完了してください。

Claude Code の設定

claude mcp add code-context-hologres \
    -e EMBEDDING_PROVIDER=DashScope \
    -e DASHSCOPE_API_KEY=sk-your-dashscope-api-key \
    -e EMBEDDING_MODEL=text-embedding-v4 \
    -e EMBEDDING_BATCH_SIZE=10 \
    -e HOLOGRES_HOST=your-hologres-instance.hologres.aliyuncs.com \
    -e HOLOGRES_PORT=80 \
    -e HOLOGRES_DATABASE=your-database-name \
    -e HOLOGRES_USER=your-access-id \
    -e HOLOGRES_PASSWORD=your-access-secret \
  -- npx code-context-mcp-hologres@latest

{
  "mcpServers": {
    "code-context-hologres": {
      "command": "npx",
      "args": ["-y", "code-context-mcp-hologres@latest"],
      "env": {
        "EMBEDDING_PROVIDER": "DashScope",
        "DASHSCOPE_API_KEY": "sk-your-dashscope-api-key",
        "EMBEDDING_MODEL": "text-embedding-v4",
        "EMBEDDING_BATCH_SIZE": "10",
        "HOLOGRES_HOST": "your-hologres-instance.hologres.aliyuncs.com",
        "HOLOGRES_PORT": "80",
        "HOLOGRES_DATABASE": "your-database-name",
        "HOLOGRES_USER": "your-access-id",
        "HOLOGRES_PASSWORD": "your-access-secret"
      }
    }
  }
}

claude mcp list

Qwen Code の設定

qwen mcp add \
    -t stdio \
    -e EMBEDDING_PROVIDER=DashScope \
    -e DASHSCOPE_API_KEY=sk-your-dashscope-api-key \
    -e EMBEDDING_MODEL=text-embedding-v4 \
    -e EMBEDDING_BATCH_SIZE=10 \
    -e HOLOGRES_HOST=your-hologres-instance.hologres.aliyuncs.com \
    -e HOLOGRES_PORT=80 \
    -e HOLOGRES_DATABASE=your-database-name \
    -e HOLOGRES_USER=your-access-id \
    -e HOLOGRES_PASSWORD=your-access-secret \
    code-context-hologres \
    npx -y code-context-mcp-hologres@latest

{
  "mcpServers": {
    "code-context-hologres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "code-context-mcp-hologres@latest"],
      "env": {
        "EMBEDDING_PROVIDER": "DashScope",
        "DASHSCOPE_API_KEY": "sk-your-dashscope-api-key",
        "EMBEDDING_MODEL": "text-embedding-v4",
        "EMBEDDING_BATCH_SIZE": "10",
        "HOLOGRES_HOST": "your-hologres-instance.hologres.aliyuncs.com",
        "HOLOGRES_PORT": "80",
        "HOLOGRES_DATABASE": "your-database-name",
        "HOLOGRES_USER": "your-access-id",
        "HOLOGRES_PASSWORD": "your-access-secret"
      }
    }
  }
}

グローバル設定ファイル

複数の MCP クライアントで Code Context Hologres を使用する場合、各クライアントで環境変数を設定する代わりに、単一のグローバル設定ファイルで認証情報を管理できます。

次の内容で ~/.context/.env ファイルを作成します：

# DashScope 埋め込みモデルの設定
EMBEDDING_PROVIDER=DashScope
DASHSCOPE_API_KEY=sk-your-dashscope-api-key
EMBEDDING_MODEL=text-embedding-v4
EMBEDDING_BATCH_SIZE=10

# Hologres データベースの設定
HOLOGRES_HOST=your-hologres-instance.hologres.aliyuncs.com
HOLOGRES_PORT=80
HOLOGRES_DATABASE=your-database-name
HOLOGRES_USER=your-access-id
HOLOGRES_PASSWORD=your-access-secret

グローバル設定ファイルを作成した後、MCP 登録コマンドを簡略化できます：

Claude Code：

claude mcp add code-context-hologres -- npx code-context-mcp-hologres@latest

Qwen Code：

qwen mcp add \
    -t stdio \
    code-context-hologres \
    npx -y code-context-mcp-hologres@latest

DashScope 埋め込みモデルの設定

Hologres データベースの設定

高度な設定

基本的なワークフロー

1. プロジェクトのディレクトリで AI コーディングアシスタント (Qwen Code または Claude Code) を開きます。

2. AI にコードベースのインデックス作成を依頼します。

3. インデックス作成のステータスを確認し、完了するのを待ちます。

4. 自然言語を使用してコードを検索します。

コードベースのインデックス作成

コードベースのインデックス作成には、プロジェクトファイルをチャンクに分割し、ベクトル埋め込みを生成し、それらを Hologres に保存する処理が含まれます。このプロセスは非同期で実行され、開始後すぐにレスポンスを返します。

AI に自然言語で依頼するだけです：

> このコードベースのインデックスを作成して

AI は自動的に index_codebase ツールを呼び出します。このツールは次のパラメーターをサポートします：

例：インデックス作成時に追加のファイルタイプを含める。

> このコードベースのインデックスを作成し、.vue と .svelte ファイルを含めて

例：強制的に再インデックスを作成する。

> 現在のコードベースのインデックスを強制的に再作成して

インデックス作成ステータス

バックグラウンドで実行されている間、いつでもインデックス作成の進捗を確認できます。AI は get_indexing_status ツールを呼び出します。

> インデックス作成のステータスを確認して

考えられるステータス：

コード検索

自然言語クエリを使用して、インデックス化されたコードベースを検索します。AI は search_code ツールを呼び出します。

> ユーザー認証を処理する関数を検索して

search_code ツールは次のパラメーターをサポートします：

その他の検索例：

> データベース接続に関連するすべてのコードを検索して

> エラー処理ロジックを検索して、ただし .py ファイルのみ

> 支払いプロセスに関連するコードスニペットを検索して

> Hologres ベクトル検索の実装コードを検索して

インデックスのクリア

コードベースのインデックスデータをクリアする必要がある場合 (例えば、埋め込みモデルを切り替えた後など)、次のように依頼できます：

> 現在のコードベースのインデックスをクリアする

AI は clear_index ツールを呼び出して、Hologres からインデックスデータを削除します。

例 (Claude Code)

$ cd /path/to/your-project
$ claude

> このコードベースのインデックスを作成して
code-context-hologres: コードベース '/path/to/your-project' のバックグラウンドインデックス作成を開始しました
AST スプリッターを使用しています。インデックス作成はバックグラウンドで実行中です。

> インデックス作成のステータスを確認して
code-context-hologres: コードベース '/path/to/your-project' は現在インデックス作成中です。
進捗：45.2% (ファイルを処理し、埋め込みを生成中...)

> インデックス作成のステータスを確認して
code-context-hologres: コードベース '/path/to/your-project' は完全にインデックス化され、検索
可能です。統計：128 ファイル、1,536 チャンク。

> ユーザーログイン認証を処理する関数を検索して
code-context-hologres: クエリ "ユーザーログイン認証" に対して 5 件の結果が見つかりました：
1. コードスニペット (TypeScript) [your-project]
   場所：src/auth/login.ts:15-42
   ...

例 (Qwen Code)

$ cd /path/to/your-project
$ qwen

> このコードベースのインデックスを作成して
code-context-hologres: コードベース '/path/to/your-project' のバックグラウンドインデックス作成を開始しました
AST スプリッターを使用しています。インデックス作成はバックグラウンドで実行中です。

> インデックス作成のステータスを確認して
code-context-hologres: コードベース '/path/to/your-project' は完全にインデックス化され、検索
可能です。統計：128 ファイル、1,536 チャンク。

> ユーザーログイン認証を処理する関数を検索して
code-context-hologres: クエリ "ユーザーログイン認証" に対して 5 件の結果が見つかりました：
1. コードスニペット (TypeScript) [your-project]
   場所：src/auth/login.ts:15-42
   ...

モデルの切り替え

EMBEDDING_MODEL 環境変数を変更することで、DashScope 埋め込みモデルを切り替えることができます。

例えば、text-embedding-v3 モデルを使用する場合：

# MCP 登録コマンドで変更
-e EMBEDDING_MODEL=text-embedding-v3

または ~/.context/.env で変更します：

EMBEDDING_MODEL=text-embedding-v3

カスタムファイル拡張子

デフォルトでは、Code Context Hologres は一般的なプログラミング言語ファイルをサポートしています。追加のファイルタイプ (例えば .vue、.svelte、.astro) のインデックスを作成する必要がある場合は、2つのオプションがあります：

方法 1：CUSTOM_EXTENSIONS 環境変数でグローバルに設定します。

CUSTOM_EXTENSIONS=.vue,.svelte,.astro

方法 2：インデックス作成時に自然言語を使用して指定します。

> このコードベースのインデックスを作成し、.vue と .svelte ファイルを含めて

カスタム無視パターン

Code Context Hologres は、プロジェクト内の .gitignore と .contextignore ファイル、およびグローバルな ~/.context/.contextignore ファイルを自動的に読み取ります。次の方法で追加の無視ルールを追加することもできます：

方法 1：CUSTOM_IGNORE_PATTERNS 環境変数を使用します。

CUSTOM_IGNORE_PATTERNS=*.test.ts,__mocks__,*.generated.ts

方法 2：インデックス作成時に自然言語を使用して指定します。

> このコードベースのインデックスを作成し、.test.ts と __mocks__ ディレクトリを無視して

コードスプリッター

Code Context Hologres は 2 つのコードスプリッターをサポートしています：

通常、これを手動で指定する必要はありません。システムはデフォルトで ast スプリッターを使用し、必要に応じて自動的にフォールバックします。

ハイブリッド検索の設定

Code Context Hologres は、より高い検索精度を実現するために、デフォルトでハイブリッド検索 (BM25 疎ベクトル + 密ベクトル) を有効にしています。これを無効にして密ベクトルのみを使用する必要がある場合は、次のように設定します：

HYBRID_MODE=false