Gongrzhe REDIS MCP Server

🚀 Redis モデルコンテキストプロトコル (MCP) サーバー (@gongrzhe/server-redis-mcp@1.0.0)

Redis データベースとのやり取りを可能にする Redis モデルコンテキストプロトコル (MCP) サーバーの実装です。このサーバーは、一連の標準化されたツールを通じて、大規模言語モデル (LLMs) が Redis キーバリューストアとやり取りできるようにします。

🚀 クイックスタート

この Redis MCP サーバーは、Redis データベースとのやり取りを容易にするためのものです。以下に、インストール方法と使用例を示します。

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Claude Desktop 用に自動で Redis MCP サーバーをインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude

手動インストール

npx を使用した指定バージョンのインストール（推奨）

npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# 例:
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

グローバルインストール

# 指定バージョンをグローバルにインストール
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# インストール後に実行
@gongrzhe/server-redis-mcp redis://your-redis-host:port

✨ 主な機能

ツール

• set

  • Redis のキーバリューペアを設定し、オプションで有効期限を指定できます。
  • 入力:
    • key (文字列)：Redis のキー
    • value (文字列)：保存する値
    • expireSeconds (数値, オプション)：有効期限（秒）

• get

  • キーに基づいて Redis から値を取得します。
  • 入力: key (文字列)：取得する Redis のキー

• delete

  • 1 つまたは複数の Redis のキーを削除します。
  • 入力: key (文字列 | 文字列配列)：キーまたはキーの配列

• list

  • パターンに基づいて一致する Redis のキーをリストします。
  • 入力: pattern (文字列, オプション)：一致させるキーのパターン（デフォルト: *）

📚 ドキュメント

Claude Desktop での使用

Claude Desktop アプリでこのサーバーを使用するには、claude_desktop_config.json ファイルの "mcpServers" セクションに以下の設定を追加します。

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

または、パッケージをインストールしている場合は、node コマンドを直接使用できます。

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Docker での使用

Docker を使用する場合:

• macOS の場合は、Redis サーバーがホストネットワークで実行されているときに host.docker.internal を使用します。
• Redis URL はパラメータとして指定でき、デフォルトは "redis://localhost:6379" です。

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-it",
        "redis:alpine",
        "redis-cli",
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

🔧 技術詳細

ビルドとテスト

プロジェクトをビルドするには、以下のコマンドを実行します。

npm run build

その後、以下のコマンドでサーバーを起動します。

node dist/index.js redis://localhost:6379

📄 ライセンス

詳細については、プロジェクトのライセンスファイルを参照してください。