View a markdown version of this page

Valkey MCP サーバーの仕組み - Amazon ElastiCache

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Valkey MCP サーバーの仕組み

Valkey MCP サーバーは、設定された Valkey データストアを操作するための構造化ツールのセットをエージェントに提供します。リクエストを行うと、エージェントは適切なツールを選択し、必要なパラメータを指定して、結果を Valkey から直接受け取ります。サーバーはコマンドの構築と検証を処理するため、エージェントはクライアントコードを生成したり、Valkey コマンドを手動でフォーマットしたりする必要はありません。

Valkey MCP サーバーには、次の機能領域があります。

機能領域 目的
Valkey オペレーション 文字列、ハッシュ、リスト、セット、ソートされたセット、ストリーム、およびその他の Valkey データ構造を読み取って変更します。
JSON オペレーション 構造化パスを使用して JSON ドキュメントと配列を保存、取得、更新します。
検索と AI ワークロード 検索インデックスの作成、ドキュメントの追加、テキスト、セマンティック、ベクトル、ハイブリッド検索の実行、結果の集計を行います。
運用上の保護 読み取り、書き込み、管理オペレーションを分離します。破壊的な管理コマンドはデフォルトで無効になっており、サーバーは読み取り専用モードで実行できます。

サーバーは構造化された JSON 入力を使用し、それらを適切な Valkey オペレーションに変換します。これにより、コマンド形式のエラーが軽減され、エージェントは一般的なデータ、検索、運用タスクにわたって一貫したインターフェイスが得られます。

コンパクトなツール表面を介した Valkey へのフルアクセス

Valkey MCP サーバーは、エージェントに 3 つの構造化ツールを通じて完全な Valkey コマンドセットへのアクセスを許可します。

  1. valkey_read は、GET、、HGETALL、 などの読み取り専用オペレーションを処理しSCANますINFO

  2. valkey_write は、SET、、HSET、 などのミューテーションをサポートしていますDELLPUSH

  3. valkey_admin では、設定と影響の大きいオペレーションについて説明します。

これにより、文字列、ハッシュ、リスト、ソートされたセット、ストリーム、pub/sub、ビットマップ、HyperLogLog などの Valkey 機能をサポートしながら、エージェントのツール表面を簡素化できます。

AI、検索、分析ワークフローの簡素化

Valkey MCP サーバーには、ベクトル検索、セマンティック検索、テキスト検索、ハイブリッド検索用の 4 つの専用ツールと集計が用意されています。エージェントは、低レベルのコマンドを構築せずにデータをクエリできるため、開発者は自然言語リクエストから作業中の Valkey 検索または AI ワークフローへの直接パスを利用できます。

  1. manage_index を使用すると、エージェントは検索インデックスを作成、削除、検査、または一覧表示できます。

  2. add_documents はドキュメントを検索インデックスに取り込み、存在しない場合はインデックスを自動的に作成します。また、デフォルトでオープンソースの埋め込みパッケージを使用し、Amazon Bedrock、OpenAI、Ollama などの設定可能なプロバイダーを使用して、セマンティック検索用のオプションの埋め込み生成もサポートしています。

  3. search は、セマンティック検索、テキスト検索、ハイブリッド検索、検索類似検索のための統合インターフェイスを提供します。指定されたパラメータから検索モードを自動的に検出します。

  4. aggregate は、、FT.AGGREGATE、、GROUPBYFILTERおよび LIMITステージをサポートするSORTBYAPPLY用の構造化パイプラインビルダーを提供します。

デバッグ時に、 searchおよび aggregate ツールを使用すると、エージェントはデータストアの実際のコンテンツを検査できます。エージェントは、インデックス付きデータを確認し、一致するドキュメントをサンプリングし、会話で直接検索結果と集計結果を検証できます。