AIでClickHouseのベクトル類似性検索を実行する方法

高次元の埋め込みをClickHouseに渡し、エンジンが距離指標を計算して最も近い一致項目を特定します。エージェントがクエリのロジックを処理し、結果を解釈します。これにより、意味的な類似性に基づいた最も関連性の高いレコードのリストが得られます。

1. 01

   データ構造の調査

   エージェントがClickHouseテーブルを確認し、埋め込みデータが格納されている特定の列を見つけ出します。

   describe_table
2. 02

   類似性検索の実行

   AIが埋め込みベクトルをClickHouseに送信し、保存されたデータに対して距離計算を実行します。

   vector_search
3. 03

   結果のフィルタリング

   エージェントは返された距離スコアを使用して、リクエストに対して最も正確な一致項目を絞り込みます。

   vector_search
4. 04

   結果の提示

   AIはデータベースの生の行を、特定の質問に答えるための読みやすい形式に変換します。

   describe_table

ClickHouse Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_567ij3B5hJvT6KRM8Z5LcFbGNttrwDvwD2OPp6c2/mcpコピー

Claude Desktop

以下の手順で数秒で接続できます。

1. 1In Claude Desktop, open Settings → Connectors.
2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3. 3Click Add and start a new chat — ClickHouse capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "clickhouse-vector-search-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_567ij3B5hJvT6KRM8Z5LcFbGNttrwDvwD2OPp6c2/mcp"
    }
  }
}

• Claude
• ChatGPT
• Cursor
• VS Code
• Windsurf
• Claude Code
• JetBrains
• Cline

認証情報を一度入力して接続を確立してください。その後、AIクライアントからClickHouseのベクトルデータへ直接アクセスできるようになります。

• 01

  AIがClickHouseのテーブルスキーマを変更することはありますか？

  いいえ。AIは検索を実行するためにテーブル構造を読み取ることはできますが、変更はできません。

• 02

  AIがベクトルデータを削除することはありませんか？

  はい、ありません。このMCPは、テーブルの記述と検索を実行するためのツールのみを提供します。

• 03

  埋め込みベクトルは自分で用意する必要がありますか？

  はい。類似性検索を行うには、クエリの基準点として使用するベクトルを自分で提供する必要があります。

• 04

  AIは標準的なSQLクエリを実行できますか？

  いいえ。AIができることは、提供されている特定のベクトル検索およびテーブル記述ツールに限定されています。

• 05

  AIはどのテーブルを検索すべきか、どうやって判断するのですか？

  プロンプト内でテーブル名を指定するか、AIがdescribeツールを使用して適切なテーブルを見つけ出します。

• ClickHouseについて他に質問がありますか？コネクタのページで確認できます。 ClickHouse Connectorの全機能を見る