Redis Cloud API MCP Server

Redis Cloud API MCP サーバー

Model Context Protocol（MCP）は、大規模言語モデル（LLM）と外部システム間のコンテキストを管理するための標準化されたプロトコルです。このリポジトリでは、Redis Cloud の API 用 MCP サーバーを提供しており、自然言語を使って Redis Cloud のリソースを管理できます。

これにより、Claude Desktop や任意の MCP クライアントで自然言語を使い、Redis Cloud アカウントで次のような操作を実行できます。

• 「AWS に新しい Redis データベースを作成して」
• 「現在のサブスクリプションを教えて」
• 「eコマースアプリケーションに適した Redis データベースを選ぶのを手伝って」

機能

アカウント管理

• get_current_account：現在の Redis Cloud アカウントの詳細を取得します
• get_current_payment_methods：アカウントに設定されているすべての支払い方法を一覧表示します

サブスクリプション管理

Pro サブスクリプション

• get_pro_subscriptions：アカウント内のすべての Pro サブスクリプションを一覧表示します
• create_pro_subscription：高度な設定オプションを使って新しい Pro サブスクリプションを作成します
  • マルチクラウドデプロイに対応
  • メモリ、永続化、モジュールを設定
  • Active-Active デプロイを設定
  • カスタムネットワーク設定

Essential サブスクリプション

• get_essential_subscriptions：すべての Essential サブスクリプションを一覧表示します（ページネーション対応）
• get_essential_subscription_by_id：特定の Essential サブスクリプションの詳細情報を取得します
• create_essential_subscription：新しい Essential サブスクリプションを作成します
• delete_essential_subscription：Essential サブスクリプションを削除します

データベースの機能

• get_database_modules：アカウントで利用可能な、サポート対象のデータベースモジュール（機能）をすべて一覧表示します
  • Redis モジュール
  • データベース機能
  • パフォーマンスオプション

クラウドプロバイダー管理

• get_pro_plans_regions：クラウドプロバイダーで利用可能なリージョンを取得します
  • AWS リージョン
  • GCP リージョン
  • ネットワークオプション
  • アベイラビリティーゾーン

プランと料金

• get_essentials_plans：利用可能な Essential サブスクリプションプランを一覧表示します（ページネーション対応）
  • AWS、GCP、Azure に対応
  • Redis Flex オプション
  • 固定プラン

タスク管理

• get_tasks：アカウント内の現在のタスクをすべて一覧表示します
• get_task_by_id：特定のタスクの詳細情報を取得します
  • デプロイ状況を追跡
  • サブスクリプションの変更を監視
  • タスクの進捗状況を確認

使用方法

前提条件

• 有効な Redis Cloud API 認証情報（API Key と Secret Key）
• 長時間実行される操作ではタスク ID が返され、状況を監視できます
• ページネーションされたレスポンスでは、すべてのデータを取得するために複数回の呼び出しが必要です

Claude Desktop

Claude Desktop で MCP サーバーを実行するには、次の手順に従います。

1. パッケージをビルドします。

   npm run build
   

2. サーバーを Claude Desktop に追加します。

   • Claude Desktop の設定を開きます
   • Developer タブに移動します（Developer Mode が有効になっていることを確認してください）
   • 「Edit config」をクリックします
   • テキストエディターで claude_desktop_config.json ファイルを開き、次の設定を追加します。

   {
     "mcpServers": {
       "mcp-redis-cloud": {
         "command": "node",
         "args": ["--experimental-fetch", "<absolute_path_to_project_root>/dist/index.js"],
         "env": {
           "API_KEY": "<redis_cloud_api_key>",
           "SECRET_KEY": "<redis_cloud_api_secret_key>"
         }
       }
     }
   }
   

3. Claude Desktop を終了して再起動します。MCP Servers セクションでサーバーを利用できるようになります。

Cursor IDE

Cursor IDE で MCP サーバーを実行するには、次の手順に従います。

1. パッケージをビルドします。

   npm run build
   

2. サーバーを Cursor に追加します。

   • Cursor Settings を開きます
   • MCP タブに移動します
   • 「Add new global MCP Server」をクリックします
   • 自動的に開かれる mcp.json ファイルを次の設定で更新します。

   {
     "mcpServers": {
       "mcp-redis-cloud": {
         "command": "node",
         "args": ["--experimental-fetch", "<absolute_path_to_project_root>/dist/index.js"],
         "env": {
           "API_KEY": "<redis_cloud_api_key>",
           "SECRET_KEY": "<redis_cloud_api_secret_key>"
         }
       }
     }
   }
   

3. Cursor を再起動します。MCP Servers セクションでサーバーを利用できるようになります。

開発

前提条件

1. nvm（Node Version Manager）
2. Node v22.14.0
3. npm 10.9.2

はじめに

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

   nvm use v22.14.0
   npm install
   

2. プロジェクトをビルドします。

   npm run build
   

3. MCP Inspector を使ってテストします。

   npx @modelcontextprotocol/inspector node dist/index.js --api-key=<api_key> --secret-key=<secret_key>
   

プロジェクト構成

src/
├── index.ts              # Entry point
├── clients/              # API Clients for external services
│   └── generated         # Generated Redis Cloud API client
└── tools/                # Tool implementations
    └── accounts/         # Account tools
    └── subscriptions/    # Subscription tools
    └── tasks/            # Task tools

注：コードを変更した場合は、Claude Desktop ／ Cursor を再ビルドして再起動してください。

npm run build

Docker の使用

Docker イメージのビルド

MCP サーバーの Docker イメージをビルドするには、次のコマンドを実行します。

docker build -t mcp/redis-cloud .

Docker コンテナの実行

コンテナを実行するには、次のコマンドを使用します。

docker run -i --rm \
  -e API_KEY=<your_redis_cloud_api_key> \
  -e SECRET_KEY=<your_redis_cloud_api_secret_key> \
  mcp/redis-cloud

Claude Desktop との Docker 統合

Docker 化した MCP サーバーを Claude Desktop と統合するには、次の手順に従います。

1. Docker イメージをビルドします（まだビルドしていない場合）。

   docker build -t mcp/redis-cloud .
   

2. Claude Desktop にサーバーを追加します。

   • Claude Desktop の設定を開きます
   • Developer タブに移動します（Developer Mode が有効になっていることを確認してください）
   • 「Edit config」をクリックします
   • テキストエディターで claude_desktop_config.json ファイルを開きます
   • 次の設定を追加します。

   {
     "mcpServers": {
       "redis-cloud": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "API_KEY=<your_redis_cloud_api_key>",
           "-e",
           "SECRET_KEY=<your_redis_cloud_api_secret_key>",
           "mcp/redis-cloud"
         ]
       }
     }
   }
   

3. プレースホルダーの値を実際の API 認証情報に置き換えます。

4. 設定ファイルを保存し、Claude Desktop を再起動します。

注意事項

• 必要な環境変数（API_KEY、SECRET_KEY）が正しく設定されていることを確認してください。