redis/redisctl

redis 资料

最近记录的来源活动: 2026年10月5日 15:04

SkillsMP 收录数据更新: 2026年10月26日 11:37

已收集 skills: 19

GitHub 星标: 18
GitHub Forks: 3

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# redisctl **Manage Redis Cloud, Redis Enterprise, and Redis databases from one tool** -- as a CLI for humans or an MCP server for AI agents. [![Crates.io](https://img.shields.io/crates/v/redisctl.svg)](https://crates.io/crates/redisctl) [![CI](https://github.com/redis/redisctl/actions/workflows/ci.yml/badge.svg)](https://github.com/redis/redisctl/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](https://github.com/redis/redisctl#license) redisctl replaces curl-and-jq scripts against the Redis Cloud and Enterprise REST APIs with a single binary that handles authentication, async polling, output formatting, and error handling. The same tool ships as an MCP server so AI assistants can manage Redis infrastructure directly. --- ## Pick Your Path | I want to... | Start here | |---|---| | Manage **Redis Cloud** from my terminal | [CLI Quick Start](#quick-start) | | Manage **Redis Enterprise** from my terminal | [CLI Quick Start](#quick-start) | | Let an **AI assistant** manage Redis | [MCP Server](#mcp-server) | | Query or inspect a **Redis database** directly | [Database Tools](#database-tools) | --- ## Quick Start ### Install ```bash # Homebrew (macOS/Linux) brew install redis/homebrew-tap/redisctl # Cargo cargo install redisctl # Binary releases: https://github.com/redis/redisctl/releases ``` ### Configure a Profile ```bash # Redis Cloud redisctl profile set prod \ --deployment cloud \ --api-key "$REDIS_CLOUD_API_KEY" \ --api-secret "$REDIS_CLOUD_SECRET_KEY" # Redis Enterprise redisctl profile set dev \ --deployment enterprise \ --url "https://cluster.local:9443" \ --username "admin@redis.local" \ --password "$REDIS_ENTERPRISE_PASSWORD" ``` ### Run Commands ```bash # List databases (platform inferred from profile) redisctl database list # Create a database and wait for it to be ready redisctl database create @db-config.json --wait # Get cluster info as a table redisctl cluster get -o table # Filter output with JMESPath redisctl database list -q 'databases[?status==`active`].name' ``` The `cloud`/`enterprise` prefix is optional -- the CLI infers the platform from your profile. Use explicit prefixes (`redisctl cloud database list`) in scripts or when you have profiles for both platforms. --- ## MCP Server `redisctl-mcp` exposes 300+ tools to AI assistants (Claude Desktop, Cursor, VS Code, or any MCP client). It provides Cloud and Enterprise management tools plus direct Redis database operations -- all with a safety-first policy system. ### Set Up ```json { "mcpServers": { "redisctl": { "command": "redisctl-mcp", "args": ["--profile", "my-profile"] } } } ``` **Read-only by default.** Write and destructive operations require explicit opt-in via a policy file (`mcp-policy.toml`): ```toml tier = "read-write" # read-only (default) | read-write | full ``` See the [MCP configuration docs](https://redis-field-engineering.github.io/redisctl-docs/mcp/configuration/) for the full policy schema and precedence rules. ### Zero-Install with Docker `REDIS_ENTERPRISE_PASSWORD` is passed without a value so Docker forwards it from your host environment (keeps the secret out of the config file): ```json { "mcpServers": { "redisctl": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "REDIS_ENTERPRISE_URL=https://cluster:9443", "-e", "REDIS_ENTERPRISE_USER=admin@redis.local", "-e", "REDIS_ENTERPRISE_PASSWORD", "ghcr.io/redis/redisctl", "redisctl-mcp" ] } } } ``` See the [MCP documentation](https://redis-field-engineering.github.io/redisctl-docs/mcp/) for client configuration guides, the full tool catalog, and safety policy reference. --- ## What's Covered Coverage varies by product/API version and between CLI commands and MCP tools. The areas below do not guarantee that every upstream endpoint is implemented or live-tested. A versioned [support and validation matrix](https://github.com/redis/redisctl/issues/1085) remains part of 1.0 readiness. ### Redis Cloud Management Subscriptions, databases, VPC peering, Transit Gateway, PrivateLink, Private Service Connect, ACLs, cloud accounts, tasks, and async operations. ### Redis Enterprise Management Clusters, nodes, shards, databases (BDBs), Active-Active (CRDBs), users, roles, LDAP, logs, metrics, alerts, support packages, and diagnostics. ### Database Tools Connect directly to Redis for key inspection, data structure operations, server diagnostics, and health checks. Available in both the CLI and MCP server. ### Key Capabilities - **Async operations** -- `--wait` automatically polls long-running operations to completion - **Output formats** -- tables, JSON, YAML, with JMESPath filtering (`-q`) - **Profiles** -- manage multiple environments with optional keyring-backed credential storage - **Workflows** -- high-level commands that compose multi-step operations (e.g., `subscription-setup`) - **Raw API access** -- `redisctl api cloud get /subscriptions/12345` sends a REST request; endpoint availability, payloads, and permissions depend on the upstream service - **Streaming** -- `--follow` for real-time log tailing --- ## Documentation **[Full Documentation](https://redis-field-engineering.github.io/redisctl-docs/)** - [Getting Started](https://redis-field-engineering.github.io/redisctl-docs/getting-started/) - [Configuration File](https://redis-field-engineering.github.io/redisctl-docs/reference/config-file/) - [MCP Server](https://redis-field-engineering.github.io/redisctl-docs/mcp/) - [Command Reference](https://redis-field-engineering.github.io/redisctl-docs/reference/) - [Compatibility and Support Policy](https://redis-field-engineering.github.io/redisctl-docs/reference/compatibility/) - Workflows: [Cloud](https://redis-field-engineering.github.io/redisctl-docs/cloud/workflows/) and [Enterprise](https://redis-field-engineering.github.io/redisctl-docs/enterprise/workflows/) --- ## Changelogs - [redisctl CLI](crates/redisctl/CHANGELOG.md) - [redisctl-core](crates/redisctl-core/CHANGELOG.md) - [redisctl-mcp](crates/redisctl-mcp/CHANGELOG.md) API client libraries (separate repositories): - [redis-cloud](https://github.com/redis-developer/redis-cloud-rs) - [redis-enterprise](https://github.com/redis-developer/redis-enterprise-rs) --- ## Contributing ```bash git clone https://github.com/redis/redisctl.git cd redisctl cargo build --release cargo test --workspace cargo clippy --all-targets -- -D warnings ``` See the [Contributing Guide](https://redis-field-engineering.github.io/redisctl-docs/developer/contributing/) and [TESTING.md](TESTING.md) for the test tiers, Docker-gated live suites, and CI gates. --- ## License Licensed under either of [Apache License 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT), at your option.

正在加载仓库 README…

这个仓库中的 skills

网络与计算机系统管理员数据库架构师软件开发工程师数据库管理员

4 个职业分类 · 已分类 84%

skill

职业分类

描述

更新

cloud-database-provisioning

未分类

Provision a Redis Cloud database end-to-end — Essentials (fixed plan) or Pro (custom) — using Redis Cloud MCP tools

原文语言：英语

2026-10-05

redisctl-setup

未分类

Set up Redis access after connecting an agent - choose a deployment, configure credentials locally, validate connectivity, and run a first read-only operation

原文语言：英语

2026-10-05

redisctl-cloud-quickstart

未分类

Provision a free Redis Cloud database for an app or agent in one step and connect to it. Use when someone needs a working Redis quickly, wants a REDIS_URL in their .env, or asks to "spin up a Redis database". Covers login, quick-database, and safe credential…

原文语言：英语

2026-09-24

redisctl-enterprise-admin

网络与计算机系统管理员

Advanced Redis Enterprise administration via the redisctl CLI. Use for RBAC, LDAP, cluster policy, licensing, certificates, proxy management, and diagnostics.

原文语言：英语

2026-08-04

enterprise-health-check

网络与计算机系统管理员

Comprehensive pre-operation health check for a Redis Enterprise cluster — verify cluster state, node health, license status, and active alerts before making changes

原文语言：英语

2026-06-03

redisctl-enterprise-ops

网络与计算机系统管理员

Day-to-day Redis Enterprise cluster operations via the redisctl CLI. Use when checking cluster status, managing databases, viewing stats and logs, or monitoring Active-Active deployments.

原文语言：英语

2026-06-03

redisctl-networking

网络与计算机系统管理员

Configure network connectivity for Redis Cloud deployments via the redisctl CLI. Use when setting up VPC peering, Transit Gateway, Private Service Connect, or PrivateLink.

原文语言：英语

2026-06-03

redisctl-cloud-management

网络与计算机系统管理员

Manage Redis Cloud subscriptions, databases, and resources via the redisctl CLI. Use when provisioning, updating, or monitoring Redis Cloud infrastructure.

原文语言：英语

2026-06-03

redisctl-setup

软件开发工程师

Install and configure redisctl CLI for Redis Cloud, Enterprise, and direct database access. Use when setting up redisctl for the first time, creating profiles, or configuring shell completions.

原文语言：英语

2026-06-03

compare-approaches

软件开发工程师

Prototype and compare 2-3 Redis data model alternatives for the same workload

原文语言：英语

2026-03-19

data-explorer

数据库管理员

Profile and explore a Redis dataset - key types, sizes, TTLs, encodings, and sample values

原文语言：英语

2026-03-19

data-modeling-advisor

数据库架构师

Recommend Redis data structures and patterns for a given workload before committing to an approach

原文语言：英语

2026-03-19

index-audit

数据库管理员

Audit a RediSearch index for health, efficiency, and optimization opportunities

原文语言：英语

2026-03-19

index-migration

数据库架构师

Plan and execute a zero-downtime RediSearch index schema migration using aliases

原文语言：英语

2026-03-19

redisctl-database-connect

软件开发工程师

Connect to Redis databases using the redisctl CLI. Use when opening redis-cli sessions, managing connection profiles, or working with multiple Redis clusters.

原文语言：英语

2026-03-17

redisctl-workflows

网络与计算机系统管理员

Multi-step operational workflows combining redisctl commands. Use for end-to-end provisioning, cluster initialization, migrations, and backup and recovery procedures.

原文语言：英语

2026-03-17

query-tuning

软件开发工程师

Analyze and optimize RediSearch queries using FT.EXPLAIN and FT.PROFILE

原文语言：英语

2026-03-11

index-ab-test

数据库架构师

Create and compare multiple RediSearch index configurations to find the best one

原文语言：英语

2026-03-07

index-advisor

数据库架构师

Analyze a Redis dataset and recommend an optimal RediSearch index schema

原文语言：英语

2026-03-07

已展示 19 / 19 个已收集 Skill。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/redis/redisctl.