Redis Cloud API MCP Server

🚀 Redis 雲 API MCP 服務器

模型上下文協議（MCP）是一種標準化協議，用於在大型語言模型（LLMs）和外部系統之間管理上下文。本項目提供了一個基於 Redis Cloud API 的 MCP 服務器，讓您能夠使用自然語言管理 Redis Cloud 資源。藉助該服務器，您可以使用 Claude Desktop 或任何 MCP 客戶端，通過自然語言完成在 Redis Cloud 賬戶上的各類任務，例如：

• "創建 AWS 上的新 Redis 數據庫"
• "我的當前訂閱有哪些？"
• "幫我選擇適合我電子商務應用程序的 Redis 數據庫"

✨ 主要特性

賬號管理

• get_current_account：獲取當前 Redis Cloud 賬戶的詳細信息。
• get_current_payment_methods：列出賬戶中配置的所有付款方式。

訂閱管理

Pro 訂閱

• get_pro_subscriptions：列出賬戶中的所有 Pro 訂閱。
• create_pro_subscription：創建新的 Pro 訂閱，支持高級配置選項，包括：
  • 支持多雲部署。
  • 可配置內存、持久性和模塊。
  • 可設置主動（active）部署。
  • 支持自定義網絡配置。

必要訂閱

• get_essential_subscriptions：分頁列出所有必要訂閱。
• get_essential_subscription_by_id：獲取特定必要訂閱的詳細信息。
• create_essential_subscription：創建新的必要訂閱。
• delete_essential_subscription：刪除必要的訂閱。

數據庫功能

• get_database_modules：列出賬戶中支持的所有數據庫模塊（功能），涵蓋 Redis 模塊、數據庫功能和性能選項。

雲提供商管理

• get_pro_plans_regions：獲取所有 Pro 計劃的區域信息，包括 AWS 區域、GCP 區域、網絡選項和可用性區域。

計劃和定價

• get_essentials_plans：分頁列出可用的必要訂閱計劃，支持 AWS、GCP 和 Azure，包含 Redis Flex 選項和固定計劃。

任務管理

• get_tasks：列出賬戶中的所有當前任務。
• get_task：獲取特定任務的詳細信息。
• create_task：創建新任務。
• update_task：更新現有任務。
• delete_task：刪除任務。

📦 安裝指南

入門指南

1. 安裝依賴：
   • 確保已安裝 Node.js 和 TypeScript。
   • 安裝所需依賴項，如 @types/node、express 和 typescript。
2. 配置 API 密鑰：在環境變量中設置 REDIS_CLOUD_API_KEY 和 REDIS_CLOUD_SECRET_KEY。
3. 運行服務器：

npm start

Docker 使用

構建 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

1. 構建 Docker 鏡像（如果尚未構建）：

docker build -t mcp/redis-cloud .

2. 添加服務器到 Claude Desktop：
   • 打開 Claude Desktop 設置。
   • 導航到開發者選項卡（確保已啟用開發人員模式）。
   • 點擊“編輯配置”。
   • 打開 claude_desktop_config.json 文件。
   • 添加以下配置：

{
  "mcpServers": {
    "redis-cloud": {
      "command": "docker",
      "args": [
        "run",
        "-i"
      ]
    }
  }
}

💻 使用示例

基礎用法

# 啟動服務器
npm start

高級用法

# 使用 Docker 構建並運行鏡像
docker build -t mcp/redis-cloud .
docker run -i --rm -e API_KEY=<your_redis_cloud_api_key> -e SECRET_KEY=<your_redis_cloud_api_secret_key> mcp/redis-cloud

📚 詳細文檔

項目結構

src/
├── index.ts              # 入口點
├── clients/              # 外部服務 API 客戶端
│   └── generated         # 自動生成的 Redis Cloud API 客戶端
└── tools/                # 工具實現
    └── accounts/         # 賬號工具
    └── subscriptions/    # 訂閱工具
    └── tasks/            # 任務工具