Prajwalnayak7 MCP Server Redis

🚀 MCP Server Redis

このプロジェクトは、Redis との接続管理や操作を行うサーバーを提供します。MCP フレームワークと統合され、Redis の機能を簡単に利用できるようになっています。

🚀 クイックスタート

プロジェクト構造

mcp-server-redis/
├── src/
│   ├── __init__.py
│   ├── main.py           # メインプログラムのエントリーポイント
│   ├── config.py         # 設定管理
│   ├── connection.py     # Redis 接続管理
│   ├── resources/        # リソースの実装
│   │   ├── __init__.py
│   │   ├── status.py     # 接続状態リソース
│   │   └── keys.py       # キー関連のリソース
│   └── tools/           # ツールの実装
│       ├── __init__.py
│       ├── basic.py     # 基本的な Redis 操作
│       ├── lists.py     # リスト操作
│       ├── hashes.py    # Hash テーブル操作
│       ├── sets.py      # 集合操作
│       └── pubsub.py    # 発行/購読操作
├── tests/              # テストディレクトリ
│   └── __init__.py
├── README.md
└── pyproject.toml

使用方法

依存関係のインストール：

まだインストールされていない場合は、以下の依存関係をインストールしてください。

[インストールされていない場合]https://docs.astral.sh/uv/ を参照してください。

uv venv
source .venv/bin/activate
uv sync

.env.example ファイルを参考に Redis 接続を設定し、必要な変数を追加してください。

サーバーの起動：

python src/server.py

✨ 主な機能

リソース：

• redis://status - 現在の接続状態
• redis://info - Redis サーバー情報
• redis://keys/{pattern} - 指定されたパターンに一致するキーを一覧表示

ツール：

基本操作：

• get_value - 値を取得する
• set_value - 値を設定する（オプションで有効期限を設定できます）
• delete_key - キーを削除する
• increment - 数値をインクリメントする

リスト操作：

• list_push - リストに値を追加する
• list_range - リストの範囲内の値を取得する

Hash テーブル操作：

• hash_set - Hash フィールドを設定する
• hash_get - Hash フィールドを取得する

集合操作：

• set_add - 集合に追加する
• set_members - 集合のメンバーを取得する

発行/購読操作：

• publish_message - メッセージを発行する

各ツールにはエラー処理が含まれており、意味のある応答を返します。サーバーは接続が失われた後、自動的に Redis に再接続します。

以下の方法でテストできます：

mcp dev src/server.py

または、Claude Desktop でインストールできます：

mcp install src/server.py

💻 使用例

基本的な使用法

ユーザー: 現在の Redis の接続状態はどうですか？
LLM: Redis の接続状態を確認します。

[リソース redis://status を読み取る]

Redis サーバーは現在正常に接続されており、localhost:6379、データベース 0 で動作しています。

ユーザー: 私の名前 "Alice" を Redis に保存できますか？
LLM: set_value ツールを使用して名前を保存します。

[set_value を呼び出し、キー="name"、値="Alice"]
キー 'name' が正常に設定されました。

Redis のキー "name" に名前 "Alice" を保存しました。保存が正しく行われたか確認しますか？

ユーザー: 確認してください
LLM: get_value ツールを使用して確認します。

[get_value を呼び出し、キー="name"]
Alice

確かに、名前 "Alice" が Redis に正常に保存され、正しく取得できることを確認できました。保存された値は設定した値と一致しています。

📚 ドキュメント

この実装は、MCP フレームワーク内の Redis 統合の堅実な基礎を提供します。具体的なニーズに応じて、より多くの Redis コマンドを追加することで、このプロジェクトの機能をさらに拡張することができます。