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

# 開始方法
<a name="agent-tools-valkey-mcp-getting-started"></a>

## インストール
<a name="agent-tools-valkey-mcp-installation"></a>

**前提条件:** Python 3.10 以降、`uv`、Valkey データストアへのアクセス

**MCP クライアントを設定する:** MCP クライアント設定に以下を追加します。

```
{
  "mcpServers": {
    "valkey": {
      "command": "uvx",
      "args": ["awslabs.valkey-mcp-server@latest"],
      "env": {
        "VALKEY_HOST": "<your-endpoint>",
        "VALKEY_SSL": "true"
      }
    }
  }
}
```

を Valkey データストアのエンドポイント`<your-endpoint>`に置き換えます。コーディングエージェントには、エンドポイントへのネットワークアクセスが必要です。

**Amazon ElastiCache への接続:** ElastiCache Valkey クラスターはプライベート VPC 内にあり、ローカルマシンから直接アクセスすることはできません。SSM トンネルのセットアップ、IAM 認証トークンの生成、トンネルモードでの TLS 処理については、 AWS エージェントツールキットの [ElastiCache 接続ガイド](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md)を参照するか、[Amazon ElastiCache スキル](agent-tools-skills.md)をインストールして、エージェントが接続セットアップをend-to-endで処理できるようにします。トンネルが確立されたら、上記の設定`VALKEY_HOST=127.0.0.1`で を使用します。

設定を保存したら、MCP クライアントを再起動します。

エージェントに、以下との接続を確認するように求めることができます。

*Valkey MCP サーバーを使用して、データストアへの接続を確認し、Valkey オペレーションが使用可能であることを確認します。*

## 設定
<a name="agent-tools-valkey-mcp-configuration"></a>

MCP クライアント設定の環境変数を使用して Valkey MCP サーバーを設定します。`--readonly` フラグを使用して、エージェントアクセスを読み取り専用オペレーションに制限することもできます。


<table>
<thead>
  <tr><th>変数</th><th>目的</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Valkey データストアのエンドポイントを指定します。トンネルを介してプライベート ElastiCache クラスターに接続する127.0.0.1ときに使用します。</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>TLS を有効にするtrueには、 に設定します。これは、転送中の暗号化が有効になっている ElastiCache クラスターに必要です。</td></tr>
  <tr><td>--readonly</td><td>サーバーを読み取り階層に制限し、すべての書き込みおよび管理ツールを無効にするため、本稼働環境の探索に適しています。</td></tr>
  <tr><td colspan="2">オプションの検索パラメータ</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>add\_documents および で使用される埋め込みプロバイダーを選択しますsearch。サポートされているオプションは、bedrock、openai、ollama、および ですhash。認証情報を使用しないローカルテストhashに を使用します。</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>デフォルトの Amazon Bedrock 埋め込みモデルを上書きします。</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>が に設定されている場合に必要な API キーEMBEDDING\_PROVIDERを提供しますopenai。</td></tr>
</tbody>
</table>