Home
Login

公式Redis MCPサーバー。スマートエージェントアプリケーション向けに自然言語インターフェースを提供し、Redisデータを効率的に管理および検索します。

MITPython 88redis Last Updated: 2025-06-08

Redis MCPサーバー - プロジェクト詳細

プロジェクト概要

Redis MCPサーバーは、Redis公式が開発したモデルコンテンツプロトコル(Model Content Protocol: MCP)サーバーであり、AIエージェントアプリケーションに自然言語インターフェースを提供し、Redis内のデータを効率的に管理および検索できるようにします。このプロジェクトはMCPクライアントとシームレスに統合されており、AI駆動のワークフローとRedis内の構造化および非構造化データとのインタラクションをサポートします。

プロジェクトアドレス: https://github.com/redis/mcp-redis

主要な特徴

🤖 自然言語クエリ

  • AIエージェントが自然言語を使用してRedisデータをクエリおよび更新することをサポート
  • 「会話全体をストリームに保存する」、「このアイテムをキャッシュする」、「有効期限付きのセッションを保存する」などの自然言語命令を処理可能

🔗 シームレスなMCP統合

  • あらゆるMCPクライアントと互換性があり、スムーズな通信を実現
  • stdioとSSEの2つのトランスポートプロトコルをサポート

📊 包括的なRedisサポート

Redisのすべての主要なデータ構造をサポート:

  • 文字列(String): 単純な構成値、セッションデータ、またはキャッシュされた応答を保存
  • ハッシュ(Hash): フィールドと値のペアを保存し、ベクトル埋め込みストレージをサポート
  • リスト(List): キュー、メッセージブローカー、または最近の操作のリストを維持
  • セット(Set): 一意の値を追跡し、セット演算をサポート
  • ソート済みセット(Sorted Set): ランキング、優先度付きキュー、時間ベースの分析
  • パブリッシュ/サブスクライブ(Pub/Sub): リアルタイム通知、チャットアプリケーション、更新の配布
  • ストリーム(Streams): イベントソーシング、アクティビティフィード、センサーデータロギング
  • JSON: 複雑なネストされたデータ構造、ドキュメントデータベース

🔍 検索とフィルタリング

  • 効率的なデータ検索と検索をサポート
  • ベクトルインデックス管理とベクトル検索機能
  • クエリエンジンツール

⚡ 高性能と軽量

  • 高性能データ操作のために設計
  • スケーラブルなアーキテクチャ

インストールと設定

環境要件

  • Python 3.13+
  • uvパッケージマネージャー
  • Redisサーバー

インストール手順

# リポジトリをクローン
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# uvを使用して依存関係をインストール
uv venv
source .venv/bin/activate
uv sync

環境変数設定

変数名 説明 デフォルト値
REDIS_HOST Redis IPまたはホスト名 "127.0.0.1"
REDIS_PORT Redisポート 6379
REDIS_USERNAME データベースユーザー名 "default"
REDIS_PWD データベースパスワード ""
REDIS_SSL SSL/TLSの有効/無効 False
REDIS_CA_PATH CA証明書パス None
REDIS_SSL_KEYFILE クライアント秘密鍵ファイル None
REDIS_SSL_CERTFILE クライアント証明書ファイル None
REDIS_CERT_REQS サーバー証明書を検証するかどうか "required"
REDIS_CA_CERTS 信頼できるCA証明書ファイルパス None
REDIS_CLUSTER_MODE Redisクラスタモードを有効にする False
MCP_TRANSPORT トランスポートプロトコル(stdio/sse) stdio

デプロイ方法

1. ローカルプロセス方式 (デフォルト)

# stdioトランスポートを使用
uv run src/main.py

2. ネットワークサービス方式

# SSEトランスポートを設定
export MCP_TRANSPORT="sse"
uv run src/main.py

# サーバーをテスト
curl -i http://127.0.0.1:8000/sse

3. Dockerデプロイ

# イメージをビルド
docker build -t mcp-redis .

# コンテナを実行
docker 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

統合方法

Claude Desktop統合

claude_desktop_config.jsonファイルを編集:

{
  "mcpServers": {
    "redis": {
      "command": "<uvコマンドのフルパス>",
      "args": [
        "--directory",
        "<MCPサーバーディレクトリ>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redisホスト名>",
        "REDIS_PORT": "<Redisポート>",
        "REDIS_PWD": "<Redisパスワード>",
        "REDIS_SSL": true,
        "REDIS_CA_PATH": "<CA証明書パス>"
      }
    }
  }
}

VS Code統合

プロキシモードを有効にし、mcp.jsonを設定:

{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<uvコマンドのフルパス>",
      "args": [
        "--directory",
        "<MCPサーバーディレクトリ>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redisホスト名>",
        "REDIS_PORT": "<Redisポート>",
        "REDIS_USERNAME": "<Redisユーザー名>",
        "REDIS_PWD": "<Redisパスワード>"
      }
    }
  }
}

OpenAIエージェントSDK統合

# SDKをインストール
pip install openai-agents

# APIキーを設定
export OPENAI_API_KEY="<openai_token>"

# アプリケーションを実行
python3.13 redis_assistant.py

自動デプロイ (Smithery)

# Smitheryを使用してClaude Desktopを自動構成
npx -y @smithery/cli install @redis/mcp-redis --client claude

アプリケーションシナリオ

🤖 AIアシスタント

  • 大規模言語モデルがRedis内のデータを取得、保存、および処理できるようにする
  • インテリジェントなデータ管理とクエリを実現

💬 チャットボットと仮想エージェント

  • 会話データを取得
  • メッセージキューを管理
  • 応答をパーソナライズ

📈 データ検索と分析

  • リアルタイムな洞察クエリ
  • 高速なデータ検索
  • ベクトル類似性検索

🔄 イベント処理

  • Redisストリームを使用してイベントストリームを管理
  • リアルタイムデータ処理
  • イベントソーシング

デバッグとトラブルシューティング

MCPインスペクター

# 可視化デバッグ
npx @modelcontextprotocol/inspector uv run src/main.py

ログ監視

# Claudeログを監視
tail -f ~/Library/Logs/Claude/mcp-server-redis.log

OpenAIダッシュボード

OpenAIダッシュボードを通じて、エージェントワークフローのトラブルシューティングを行うことができます。

開発と貢献

貢献フロー

  1. リポジトリをフォーク
  2. 新しいブランチを作成 (feature-branch)
  3. 変更をコミット
  4. ブランチにプッシュしてPRを送信

技術スタック

  • 言語: Python 3.13+
  • パッケージ管理: uv
  • プロトコル: MCP (Model Content Protocol)
  • データベース: Redis
  • コンテナ化: Docker

ライセンスとサポート

  • ライセンス: MIT License
  • テクニカルサポート: GitHub Issuesを通じてサポートを受ける

まとめ

Redis MCPサーバーは、AIエージェントとRedisデータベース間のギャップを埋める強力なツールであり、自然言語インターフェースを通じてAIアプリケーションがよりインテリジェントにデータを管理およびクエリできるようにします。インテリジェントアシスタント、チャットボットの構築、またはリアルタイムデータ分析の実行など、このプロジェクトは信頼性が高く効率的なソリューションを提供します。

そのモジュール式の設計、豊富なRedisデータ構造のサポート、および複数のデプロイメント方法により、小規模プロジェクトからエンタープライズレベルのアプリケーションまで、さまざまなシナリオに適しています。Claude、VS Code、OpenAIなどの主要プラットフォームとの統合により、開発者はRedisの強力な機能をAI駆動アプリケーションに簡単に組み込むことができます。

すべての詳細は、公式サイトの発表を基準にしてください (https://github.com/redis/mcp-redis)