Redis MCP Server

Redis MCP サーバー

MCP（Model Control Protocol）統合を備え、Docker でコンテナ化された、Redis サーバーのプロフェッショナルな実装です。

特長

• 永続化機能を備えた Redis サーバー
• Redis 操作用の MCP サーバー統合
• Docker と Docker Compose のサポート
• 包括的なエラー処理とログ記録
• 環境変数による設定
• Redis サービスのヘルスチェック

前提条件

• Docker
• Docker Compose

クイックスタート

1. リポジトリをクローンします。

git clone https://github.com/cbuitragoh/customRedis.git
cd customredis

2. サービスを起動します。

docker-compose up -d

3. ログを確認します。

docker-compose logs -f

利用可能な Redis 操作

MCP サーバーでは、次の Redis 操作を利用できます。

• set_redis_key(key: str, value: str): キーと値のペアを設定します
• get_redis_key(key: str): キーを指定して値を取得します
• delete_redis_key(key: str): キーを削除します
• list_redis_keys(pattern: str = '*'): パターンに一致するすべてのキーを一覧表示します

設定

アプリケーションは環境変数で設定できます。

• REDIS_HOST: Redis サーバーのホスト（デフォルト：redis）
• REDIS_PORT: Redis サーバーのポート（デフォルト：6379）
• REDIS_DB: Redis データベース番号（デフォルト：0）
• LOG_LEVEL: ログレベル（デフォルト：INFO）

開発

ローカル開発

1. 仮想環境を作成します。

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. 依存関係をインストールします。

pip install -r requirements.txt

3. サーバーを実行します。

python src/server.py

Docker での開発

1. イメージをビルドします。

docker-compose build

2. サービスを実行します。

docker-compose up

プロジェクト構成

.
├── src/
│   └── server.py      # Main server implementation
├── Dockerfile         # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── requirements.txt   # Python dependencies
├── .env              # Environment variables
└── README.md         # This file

エラー処理

アプリケーションには、次の包括的なエラー処理が含まれています。

• 接続エラー
• Redis 操作エラー
• サーバーの起動／終了エラー
• キーボード割り込み時の正常なシャットダウン

ログ記録

アプリケーションでは Python の logging モジュールを使用し、次の機能を提供します。

• タイムスタンプ付きのログエントリ
• さまざまなログレベル（INFO、WARNING、ERROR）
• 詳細なエラーメッセージ
• 操作の成功／失敗のログ記録

Claude Desktop での使用

この Redis MCP サーバーを Claude Desktop で使用するには、次の設定を Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "redis": {
            "command": "docker",
            "args": [
                "run", 
                "-i",
                "--rm",
                "--network",
                "customredis_redis-network",
                "customredis-mcp-server"]
    }
  }
}

この設定では、次のことを行います。

• Docker を使用して Redis MCP サーバーを実行します
• ホストマシンの Redis インスタンスを使用して Redis に接続します
• インタラクティブモード（-i）で実行します
• 使用後にコンテナを削除します（--rm）
• MCP サーバーを Redis コンテナと同じネットワークに接続します

次の点を確認してください。

1. docker-compose の redis サービスで Redis がコンテナ内で実行されている
2. Redis ポート（6379）にアクセスできる
3. システムで Docker が実行されている

ライセンス

MIT ライセンス