Redis CRUD MCP サーバー

これは、Redisデータベース操作のためのMCP (Model Context Protocol) サーバープラグインであり、完全なCRUD操作ツールを提供します。

✨ 特徴

• 🔍 プロジェクト設定の自動検出 - .env ファイルを上位ディレクトリに向かって検索し、プロジェクトルートを特定します

• 🔄 マルチプロジェクトサポート - プロジェクトごとに異なるRedis接続を自動的に使用します

• ⏱️ 接続タイムアウト保護 - デフォルトで10秒のタイムアウトを設定。環境変数で構成可能です

• 📝 多様な設定フォーマット - INIセクション形式とKEY=VALUE形式の両方をサポート

• 🛠️ マルチツール互換性 - Claude Code、Cline、Codexなどをサポート

🚀 クイックスタート

グローバルインストール（推奨）

npm install -g redis-crud-server

MCP設定

プロジェクトルートに .mcp.json を作成します：

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server"
    }
  }
}

⚙️ 設定説明

設定フォーマット1：INIセクション形式

[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD = your_password
SELECT = 0

設定フォーマット2：KEY=VALUE形式

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

サポートされている設定名

🔧 ツールリスト

文字列操作

• redis_set - 文字列のキーと値を設定

• redis_get - 文字列のキーと値を取得

• redis_del - キーを削除

• redis_exists - キーが存在するか確認

ハッシュ操作

• redis_hset - ハッシュフィールドを設定

• redis_hget - ハッシュフィールドを取得

• redis_hgetall - ハッシュの全フィールドを取得

• redis_hdel - ハッシュフィールドを削除

情報

• redis_info - 接続情報を取得

⏱️ タイムアウト設定

デフォルトの接続タイムアウトは10秒です。環境変数で設定可能です：

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server",
      "env": {
        "REDIS_TIMEOUT": "30000"
      }
    }
  }
}

📝 使用例

キーと値を設定

redis_set: key=test_key, value=hello_world

キーと値を取得

redis_get: key=test_key

ハッシュ操作

redis_hset: key=user:1, field=name, value=张三
redis_hget: key=user:1, field=name
redis_hgetall: key=user:1

🐛 トラブルシューティング

接続タイムアウト

• ネットワーク接続とファイアウォールの設定を確認してください

• Redisサーバーにアクセス可能であることを確認してください

• REDIS_TIMEOUT 環境変数を調整してください

設定ファイルが見つからない

• .env ファイルがプロジェクトルートにあることを確認してください

• MCPは自動的に上位ディレクトリに向かって .env ファイルを検索します

INI形式の解析失敗

• 正しいセクション名 [REDIS] を使用していることを確認してください

• Windows (\r\n)、Unix (\n)、旧Mac (\r) の改行コードをサポートしています

📄 ライセンス

MIT