Redis MCP Server

Redis MCP Server

概要

Redis MCP Server は、Redis のデータを効率的に管理・検索するために、エージェント型アプリケーション向けに設計された自然言語インターフェースです。MCP（Model Content Protocol）クライアントとシームレスに統合され、AI 主導のワークフローから Redis の構造化データや非構造化データを操作できます。この MCP サーバーを使うと、次のような質問をできます。

• 「会話全体をストリームに保存して」
• 「この項目をキャッシュして」
• 「有効期限を設定してセッションを保存して」
• 「このベクトルにインデックスを作成して検索して」

目次

• 概要
• 機能
• ツール
• インストール
  • PyPI から（推奨）
  • PyPI パッケージのテスト
  • GitHub から
  • 開発用インストール
  • Docker を使用
• 設定
  • Redis ACL
  • コマンドライン引数による設定
  • 環境変数による設定
  • Azure Managed Redis の EntraID 認証
  • ログ記録
• 統合
  • OpenAI Agents SDK
  • Augment
  • Claude Desktop
  • GitHub Copilot を使用した VS Code
• テスト
• ユースケースの例
• コントリビューション
• ライセンス
• バッジ
• お問い合わせ

機能

• 自然言語クエリ：AI エージェントが自然言語で Redis にクエリを実行し、データを更新できます。
• シームレスな MCP 統合：あらゆるMCP クライアントと連携し、スムーズに通信できます。
• Redis を幅広くサポート：ハッシュ、リスト、セット、ソート済みセット、ストリームなどを扱えます。
• 検索とフィルタリング：Redis 内のデータを効率よく取得・検索できます。
• スケーラブルで軽量：高性能なデータ操作を実現するよう設計されています。
• EntraID 認証：Azure Managed Redis での Azure Active Directory 認証をネイティブにサポートします。
• Redis MCP Server は stdio トランスポートをサポートしています。stremable-http トランスポートのサポートは今後追加される予定です。

ツール

この MCP サーバーでは、Redis に保存されているデータを管理するツールを利用できます。

• string ツールでは、有効期限付きの文字列を設定・取得できます。簡単な設定値、セッションデータ、レスポンスのキャッシュの保存に便利です。
• hash ツールでは、単一のキー内にフィールドと値のペアを保存できます。ハッシュにはベクトル埋め込みを保存できます。複数の属性を持つオブジェクト、ユーザープロフィール、各フィールドに個別にアクセスできる商品情報の表現に便利です。
• list ツールでは、項目の追加や取り出しなど、一般的な操作を行えます。キュー、メッセージブローカー、直近の操作の一覧の維持に便利です。
• set ツールでは、セットのメンバーを追加、削除、一覧表示できます。ユーザー ID やタグなどの一意の値の追跡や、共通部分の抽出などのセット演算に便利です。
• sorted set ツールでは、スコアに基づいて順序付けられたデータを管理できます。リーダーボード、優先度キュー、時間ベースの分析などに利用できます。
• pub/sub 機能では、メッセージのパブリッシュ、状態を保持するチャネルまたはパターンのサブスクリプションの作成、返されたサブスクリプションハンドルを使用したキュー内のメッセージの読み取りを行えます。リアルタイム通知、チャットアプリケーション、複数のクライアントへの更新の配信に便利です。
• streams ツールでは、データストリームへの追加、読み取り、削除、コンシューマーグループの作成と破棄、処理済みエントリーの確認を行えます。イベントソーシング、アクティビティフィード、Redis Streams のコンシューマーグループを使用するワーカー主体のイベント処理に便利です。
• JSON ツールでは、Redis 内の JSON ドキュメントの保存、取得、操作を行えます。複雑な入れ子構造のデータ、ドキュメントデータベース、パスベースのアクセスを利用する構成管理に便利です。

追加のツールです。

• docs ツールでは、自然言語の質問を使って Redis のドキュメント、チュートリアル、ベストプラクティスを検索できます（MCP_DOCS_SEARCH_URL HTTP API を使用）。
• query engine ツールでは、ベクトルインデックスを管理し、ベクトル検索を実行できます。
• server management ツールでは、データベースに関する情報を取得できます。

インストール

Redis MCP サーバーは、PyPI パッケージとして、また GitHub リポジトリから直接インストールできます。

PyPI からインストールする（推奨）

PyPI から最新バージョンの Redis MCP サーバーを構成するには、例として、以下の JSON 構成を目的のフレームワークまたはツールにインポートします。 uvx コマンドは、サーバーをその場でダウンロードし（キャッシュにない場合）、一時環境を作成して実行します。

{
  "mcpServers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "\"redis://localhost:6379/0\""
      ]
    }
  }
}

URL の指定

--url 引数の指定形式は、redis および rediss スキームに従います。

redis://user:secret@localhost:6379/0?foo=bar&qux=baz

たとえば、次のようにして localhost サーバーに簡単に接続できます。

redis://localhost:6379/0

ここで 0 は、接続先として指定する論理データベースです。

データベースへの暗号化された接続（例：Redis Cloud データベースへの接続）には、rediss スキームを使用します。

rediss://user:secret@localhost:6379/0?foo=bar&qux=baz

サーバーの ID を検証するには、ssl_ca_certs を指定します。

rediss://user:secret@hostname:port?ssl_cert_reqs=required&ssl_ca_certs=path_to_the_certificate

検証なしで接続するには、ssl_cert_reqs を none に設定します。

rediss://user:secret@hostname:port?ssl_cert_reqs=none

「Available CLI Options」セクションにあるオプションを使って、接続を構成してください。

PyPI パッケージのテスト

次のようにパッケージをインストールできます。

pip install redis-mcp-server

次に、環境内で uv を使ってパッケージを起動します。

uv python install 3.14
uv sync
uv run redis-mcp-server --url redis://localhost:6379/0

ただし、MCP サーバーは、構成先のフレームワークまたはツールに処理を委任して起動するのが最も便利です。

GitHub から

uvx を使用して目的の Redis MCP Server のバージョンを設定できます。これにより、GitHub から直接実行できます（ブランチを指定するか、タグ付きリリースを使用します）。

タグ付きリリースを使用することをおすすめします。main ブランチは現在開発中のため、互換性を損なう変更が含まれる可能性があります。

例として、次のコマンドを実行すると 0.2.0 リリースを実行できます。

uvx --from git+https://github.com/redis/[email protected] redis-mcp-server --url redis://localhost:6379/0

最新バージョンのリリースノートは、Releases セクションで確認してください。 追加の例を以下に示します。

# Run with Redis URI
uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url redis://localhost:6379/0

# Run with Redis URI and SSL
uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url "rediss://<USERNAME>:<PASSWORD>@<HOST>:<PORT>?ssl_cert_reqs=required&ssl_ca_certs=<PATH_TO_CERT>"

# Run with individual parameters
uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --host localhost --port 6379 --password mypassword

# See all options
uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --help

開発用インストール

開発目的の場合、またはリポジトリをクローンする場合：

# Clone the repository
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# Install dependencies using uv
uv venv
source .venv/bin/activate
uv sync

# Run with CLI interface
uv run redis-mcp-server --help

# Or run the main file directly (uses environment variables)
uv run src/main.py

リポジトリをクローンし、依存関係をインストールして、サーバーを実行できることを確認したら、メインファイルを直接実行するこの MCP サーバーを使用するように、Claude Desktop またはその他の MCP クライアントを設定できます（環境変数を使用します）。通常、開発ではこの方法が推奨されます。 以下の例は Claude Desktop 用ですが、その他の MCP クライアントにも同様に適用できます。

1. Redis の認証情報と TLS の設定を指定します
2. uv コマンドのフルパスを取得します（例：which uv）
3. claude_desktop_config.json 設定ファイルを編集します
   • MacOS の場合は、~/Library/Application\ Support/Claude/ にあります

{
    "mcpServers": {
        "redis": {
            "command": "<full_path_uv_command>",
            "args": [
                "--directory",
                "<your_mcp_server_directory>",
                "run",
                "src/main.py"
            ],
            "env": {
                "REDIS_HOST": "<your_redis_database_hostname>",
                "REDIS_PORT": "<your_redis_database_port>",
                "REDIS_PWD": "<your_redis_database_password>",
                "REDIS_SSL": True|False,
                "REDIS_SSL_CA_PATH": "<your_redis_ca_path>",
                "REDIS_CLUSTER_MODE": True|False
            }
        }
    }
}

ログファイルを tail すると、問題のトラブルシューティングができます。

tail -f ~/Library/Logs/Claude/mcp-server-redis.log

Docker を使用する場合

このサーバーは Docker 化したデプロイメントで使用できます。独自のイメージをビルドすることも、公式の Redis MCP Docker イメージを使用することもできます。

独自のイメージをビルドする場合、Redis MCP Server に Dockerfile が用意されています。次のコマンドで、このサーバーのイメージをビルドします。

docker build -t mcp-redis .

最後に、起動時にコンテナーを作成するようクライアントを設定します。以下に Claude Desktop の例を示します。claude_desktop_config.json を編集して、次の内容を追加します。

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": ["run",
                "--rm",
                "--name",
                "redis-mcp-server",
                "-i",
                "-e", "REDIS_HOST=<redis_hostname>",
                "-e", "REDIS_PORT=<redis_port>",
                "-e", "REDIS_USERNAME=<redis_username>",
                "-e", "REDIS_PWD=<redis_password>",
                "mcp-redis"]
    }
  }
}

公式の Redis MCP Docker イメージを使用するには、イメージ名（上記の例では mcp-redis）を mcp/redis に置き換えるだけです。

設定

Redis MCP Server は、コマンドライン引数または環境変数の 2 つの方法で設定できます。 優先順位は、コマンドライン引数 > 環境変数 > デフォルト値です。

Redis ACL

Redis データベースへのアクセスを制限するように Redis ACL を設定できます。たとえば、読み取り専用ユーザーを作成するには、次のようにします。

127.0.0.1:6379> ACL SETUSER readonlyuser on >mypassword ~* +@read -@write

コマンドライン引数または環境変数を使用してユーザーを設定します。

コマンドライン引数による設定

CLI インターフェースを使用する場合、コマンドライン引数でサーバーを設定できます。

# Basic Redis connection
uvx --from redis-mcp-server@latest redis-mcp-server \
  --host localhost \
  --port 6379 \
  --password mypassword

# Using Redis URI (simpler)
uvx --from redis-mcp-server@latest redis-mcp-server \
  --url redis://user:pass@localhost:6379/0

# SSL connection
uvx --from redis-mcp-server@latest redis-mcp-server \
  --url rediss://user:[email protected]:6379/0

# See all available options
uvx --from redis-mcp-server@latest redis-mcp-server --help

使用可能な CLI オプション：

• --url - Redis 接続 URI（redis://user:pass@host:port/db）
• --host - Redis ホスト名（デフォルト：127.0.0.1）
• --port - Redis ポート（デフォルト：6379）
• --db - Redis データベース番号（デフォルト：0）
• --username - Redis ユーザー名
• --password - Redis パスワード
• --ssl - SSL 接続を有効にします
• --ssl-ca-path - CA 証明書ファイルのパス
• --ssl-keyfile - SSL キーファイルのパス
• --ssl-certfile - SSL 証明書ファイルのパス
• --ssl-cert-reqs - SSL 証明書の要件（デフォルト：required）
• --ssl-ca-certs - CA 証明書ファイルのパス
• --cluster-mode - Redis クラスターモードを有効にします

環境変数による設定

必要に応じて、環境変数を使用できます。すべての変数にデフォルト値が設定されています。

名前	説明	デフォルト値
REDIS_HOST	Redis の IP アドレスまたはホスト名	"127.0.0.1"
REDIS_PORT	Redis のポート	6379
REDIS_DB	データベース	0
REDIS_USERNAME	デフォルトのデータベースユーザー名	"default"
REDIS_PWD	デフォルトのデータベースパスワード	""
REDIS_SSL	SSL/TLS の有効化または無効化	False
REDIS_SSL_CA_PATH	サーバーの検証に使用する CA 証明書	None
REDIS_SSL_KEYFILE	クライアント認証用のクライアント秘密鍵ファイル	None
REDIS_SSL_CERTFILE	クライアント認証用のクライアント証明書ファイル	None
REDIS_SSL_CERT_REQS	クライアントがサーバーの証明書を検証するかどうか	"required"
REDIS_SSL_CA_CERTS	信頼された CA 証明書ファイルへのパス	None
REDIS_CLUSTER_MODE	Redis Cluster モードを有効にする	False

Azure Managed Redis の EntraID 認証

Redis MCP Server は、Azure Managed Redis の EntraID（Azure Active Directory）認証に対応しており、トークンを自動管理する OAuth ベースの認証を利用できます。

認証プロバイダー

サービスプリンシパル認証 - クライアント資格情報を使用するアプリケーションベースの認証：

export REDIS_ENTRAID_AUTH_FLOW=service_principal
export REDIS_ENTRAID_CLIENT_ID=your-client-id
export REDIS_ENTRAID_CLIENT_SECRET=your-client-secret
export REDIS_ENTRAID_TENANT_ID=your-tenant-id

マネージド ID 認証 - Azure でホストされるアプリケーション向け：

# System-assigned managed identity
export REDIS_ENTRAID_AUTH_FLOW=managed_identity
export REDIS_ENTRAID_IDENTITY_TYPE=system_assigned

# User-assigned managed identity
export REDIS_ENTRAID_AUTH_FLOW=managed_identity
export REDIS_ENTRAID_IDENTITY_TYPE=user_assigned
export REDIS_ENTRAID_USER_ASSIGNED_CLIENT_ID=your-identity-client-id

Azure デフォルト資格情報 - 資格情報を自動的に検出します（開発時に推奨）：

export REDIS_ENTRAID_AUTH_FLOW=default_credential
export REDIS_ENTRAID_SCOPES=https://redis.azure.com/.default

EntraID 設定変数

名前	説明	デフォルト値
REDIS_ENTRAID_AUTH_FLOW	認証フローの種類	None（EntraID は無効）
REDIS_ENTRAID_CLIENT_ID	サービスプリンシパルのクライアント ID	None
REDIS_ENTRAID_CLIENT_SECRET	サービスプリンシパルのクライアントシークレット	None
REDIS_ENTRAID_TENANT_ID	Azure テナント ID	None
REDIS_ENTRAID_IDENTITY_TYPE	マネージド ID の種類	"system_assigned"
REDIS_ENTRAID_USER_ASSIGNED_CLIENT_ID	ユーザー割り当てマネージド ID のクライアント ID	None
REDIS_ENTRAID_SCOPES	Azure デフォルト資格情報の OAuth スコープ	"https://redis.azure.com/.default"
REDIS_ENTRAID_RESOURCE	Azure Redis のリソース識別子	"https://redis.azure.com/"

主な機能

• トークンの自動更新 - 手動操作なしでバックグラウンドでトークンを更新します
• シームレスなフォールバック - EntraID が設定されていない場合は、標準の Redis 認証に切り替えます
• 複数の認証フロー - サービスプリンシパル、マネージド ID、Azure デフォルト資格情報に対応します
• エンタープライズ対応 - ID を一元管理する Azure Managed Redis 向けに設計されています

設定例

Azure CLI を使用したローカル開発の場合：

# Login with Azure CLI
az login

# Configure MCP server
export REDIS_ENTRAID_AUTH_FLOW=default_credential
export REDIS_URL=redis://your-azure-redis.redis.cache.windows.net:6379

Service Principal を使用した本番環境の場合：

export REDIS_ENTRAID_AUTH_FLOW=service_principal
export REDIS_ENTRAID_CLIENT_ID=your-app-client-id
export REDIS_ENTRAID_CLIENT_SECRET=your-app-secret
export REDIS_ENTRAID_TENANT_ID=your-tenant-id
export REDIS_URL=redis://your-azure-redis.redis.cache.windows.net:6379

Managed Identity を使用したAzure ホストアプリケーションの場合：

export REDIS_ENTRAID_AUTH_FLOW=managed_identity
export REDIS_ENTRAID_IDENTITY_TYPE=system_assigned
export REDIS_URL=redis://your-azure-redis.redis.cache.windows.net:6379

環境変数を設定する方法はいくつかあります。

1. .env ファイルを使用する： プロジェクトディレクトリに .env ファイルを配置し、各環境変数をキーと値のペアで記述します。python-dotenv、pipenv、uv などのツールを使うと、アプリケーションの実行時にこれらの変数を自動的に読み込めます。機密データをシェルの履歴やバージョン管理から除外できる（.env が .gitignore に含まれている場合）ため、設定を管理するための便利で安全な方法です。 たとえば、リポジトリに用意されている .env.example ファイルをもとに、次の内容で .env ファイルを作成します。

cp .env.example .env

次に、.env ファイルを編集して Redis の設定を行います。

または、

2. シェルで変数を設定する： アプリケーションを実行する前に、シェルで環境変数を直接エクスポートできます。たとえば、次のようにします。

export REDIS_HOST=your_redis_host
export REDIS_PORT=6379
# Other variables will be set similarly...

この方法は、一時的な上書きや簡単なテストに便利です。

ログ記録

サーバーは Python 標準のログ機能を使用し、起動時に設定されます。デフォルトでは WARNING 以上のレベルでログを記録します。MCP_REDIS_LOG_LEVEL 環境変数を使って、ログの詳細度を変更できます。

• 使用できる値（大文字と小文字を区別しません）：DEBUG、INFO、WARNING、ERROR、CRITICAL、NOTSET
• 使用できる別名：WARN → WARNING、FATAL → CRITICAL
• 符号付き（例："10"、"+20"）を含む数値も使用できます
• 未設定または認識されない場合のデフォルト値：WARNING

ハンドラーの動作

• ホスト（例：uv、VS Code、pytest）にコンソールハンドラーがすでに設定されている場合、サーバーは独自のハンドラーを追加しません。選択したレベルのログが除外されないよう、制限が厳しすぎるハンドラーのしきい値を下げるだけです。ハンドラーのしきい値を引き上げることはありません。
• ハンドラーが存在しない場合、サーバーはシンプルな形式の stderr StreamHandler を 1 つ追加します。

例

# See normal lifecycle messages
MCP_REDIS_LOG_LEVEL=INFO uv run src/main.py

# Very verbose for debugging
MCP_REDIS_LOG_LEVEL=DEBUG uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0

env に対応している MCP クライアントの設定では、Redis の設定と併せて追加します。たとえば、次のようにします。

{
  "mcpServers": {
    "redis": {
      "command": "uvx",
      "args": ["--from", "redis-mcp-server@latest", "redis-mcp-server", "--url", "redis://localhost:6379/0"],
      "env": {
        "REDIS_HOST": "localhost",
        "REDIS_PORT": "6379",
        "MCP_REDIS_LOG_LEVEL": "INFO"
      }
    }
  }
}

統合

OpenAI Agents SDK などの開発フレームワークや、Claude Desktop、VS Code、Augment などのツールへのこの MCP サーバーの統合については、以下のセクションで説明します。

OpenAI Agents SDK

この MCP サーバーを OpenAI Agents SDK と統合します。SDK と MCP の統合について詳しくは、ドキュメントをお読みください。

Python SDK をインストールします。

pip install openai-agents

OpenAI トークンを設定します。

export OPENAI_API_KEY="<openai_token>"

そして、アプリケーションを実行します。

python3.14 redis_assistant.py

OpenAI ダッシュボードを使って、エージェントのワークフローをトラブルシューティングできます。

Augment

Augment で Redis MCP サーバーを設定するには、Easy MCP 機能を使用する方法がおすすめです。

JSON を使ってサーバーをインポートし、Redis MCP サーバーを Augment で手動設定することもできます。

{
  "mcpServers": {
    "Redis MCP Server": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://localhost:6379/0"
      ]
    }
  }
}

Claude Desktop

MCP クライアントを設定する最も簡単な方法は、uvx を使用することです。次の JSON を claude_desktop_config.json に追加し、uvx へのフルパスを指定してください。

基本的な Redis 接続：

{
  "mcpServers": {
    "redis-mcp-server": {
        "type": "stdio",
        "command": "/Users/mortensi/.local/bin/uvx",
        "args": [
            "--from", "redis-mcp-server@latest",
            "redis-mcp-server",
            "--url", "redis://localhost:6379/0"
        ]
    }
  }
}

EntraID 認証を使用した Azure Managed Redis：

{
  "mcpServers": {
    "redis-mcp-server": {
        "type": "stdio",
        "command": "/Users/mortensi/.local/bin/uvx",
        "args": [
            "--from", "redis-mcp-server@latest",
            "redis-mcp-server",
            "--url", "redis://your-azure-redis.redis.cache.windows.net:6379"
        ],
        "env": {
            "REDIS_ENTRAID_AUTH_FLOW": "default_credential",
            "REDIS_ENTRAID_SCOPES": "https://redis.azure.com/.default"
        }
    }
  }
}

GitHub Copilot を使用する VS Code

VS Code で Redis MCP サーバーを使用するには、エージェントモードのツールを有効にする必要があります。次の内容を settings.json に追加してください。

{
  "chat.agent.enabled": true
}

mcp.json ファイルに次の JSON を追加すると、uvx を使って GitHub で指定したバージョンの Redis MCP サーバーを起動できます。

"servers": {
  "redis": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "--from", "redis-mcp-server@latest",
      "redis-mcp-server",
      "--url", "redis://localhost:6379/0"
    ]
  },
}

uvx のインストールメッセージを抑制する

MCP クライアントのログに警告として表示されることがある uvx のインストールメッセージを抑制するには、-qq フラグを使用します。

"servers": {
  "redis": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "-qq",
      "--from", "redis-mcp-server@latest",
      "redis-mcp-server",
      "--url", "redis://localhost:6379/0"
    ]
  },
}

-qq フラグを指定するとサイレントモードが有効になり、パッケージのインストール中に uvx が標準エラー出力へ書き込む「Installed X packages」メッセージが抑制されます。

また、uv を使用してサーバーを起動し、mcp.json を設定することもできます。通常、開発時にはこちらの方法が推奨されます。

// mcp.json
{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<full_path_uv_command>",
      "args": [
        "--directory",
        "<your_mcp_server_directory>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<your_redis_database_hostname>",
        "REDIS_PORT": "<your_redis_database_port>",
        "REDIS_USERNAME": "<your_redis_database_username>",
        "REDIS_PWD": "<your_redis_database_password>",
      }
    }
  }
}

詳しくは、VS Code のドキュメントをご覧ください。

ヒント： メッセージに #redis を含めると、Copilot chat に Redis MCP ツールを使用するよう指示できます。

注： VS Code v1.102 以降、 MCP サーバーは settings.json ではなく、専用の mcp.json ファイルに保存されるようになりました。

テスト

この MCP サーバーのビジュアルデバッグには、MCP Inspectorを使用できます。

npx @modelcontextprotocol/inspector uv run src/main.py

使用例

• AI アシスタント：LLM が Redis 内のデータを取得、保存、処理できるようにします。
• チャットボットと仮想エージェント：セッションデータの取得、キューの管理、応答のパーソナライズを行います。
• データ検索と分析：Redis にクエリを実行して、リアルタイムの分析情報と高速な検索を実現します。
• イベント処理：Redis Streams でイベントストリームを管理します。

コントリビューション

1. リポジトリをフォークします
2. 新しいブランチを作成します（feature-branch）
3. 変更をコミットします
4. ブランチにプッシュして、PR を提出します！

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

バッジ

お問い合わせ

ご質問やサポートについては、GitHub Issuesからお問い合わせください。

または、Redis Discord サーバーに参加して、#redis-mcp-server チャンネルで質問してください。