local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows interaction with Redis databases, including creating new databases, running Redis commands, listing databases, managing backups, and viewing usage statistics.
Integrates with Upstash Developer API to manage Upstash resources through natural language commands, such as creating databases, listing resources, running commands, and viewing metrics.

Servidor MCP de Upstash

El Protocolo de Contexto de Modelo (MCP) es un nuevo protocolo estandarizado para gestionar el contexto entre grandes modelos de lenguaje (LLM) y sistemas externos. En este repositorio, ofrecemos un instalador y un servidor MCP para las API de Upstash Developer .

Esto le permite utilizar cualquier cliente MCP para interactuar con su cuenta Upstash utilizando lenguaje natural, por ejemplo:

Crear una nueva base de datos Redis en us-east-1
"Listar mis bases de datos"
"Enumerar las claves que empiezan por "usuario:" en users-db"
"Crear una copia de seguridad"
"Dime los picos de rendimiento durante los últimos 7 días"

Uso

Requisitos

Node.js >= v18.0.0
Clave API de Upstash : puedes crear una desde aquí .

Cómo utilizar localmente

Instalación para Claude Desktop

Para instalar Upstash MCP Server para Claude Desktop automáticamente a través de Smithery , ejecute el siguiente comando:

npx -y @smithery/cli@latest install @upstash/mcp-server --client claude

npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>

Esto editará su archivo de configuración MCP y agregará una entrada para Upstash.

Instalación para Cursor

Para instalar Upstash MCP Server para Cursor automáticamente a través de Smithery , ejecute el siguiente comando:

npx -y @smithery/cli@latest install @upstash/mcp-server --client cursor

Agregue el siguiente comando a la configuración de MCP en Cursor. Para más información, consulte la documentación de Cursor MCP .

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

Instalación para Windsurf

Para instalar Upstash MCP Server para Windsurf automáticamente a través de Smithery , ejecute el siguiente comando:

npx -y @smithery/cli@latest install @upstash/mcp-server --client windsurf

Agregue el siguiente comando a la configuración de MCP en Windsurf. Para más información, consulte la documentación de MCP de Windsurf .

npx -y @upstash/mcp-server run <UPSTASH_EMAIL> <UPSTASH_API_KEY>

Ejecutando con Docker

También puede utilizar la imagen de Docker proporcionada para ejecutar el servidor.

docker build -t upstash-mcp .

# Run the stdio server, add this command to you MCP config
docker run --rm -i \
  -e UPSTASH_EMAIL=<UPSTASH_EMAIL> \
  -e UPSTASH_API_KEY=<UPSTASH_API_KEY> \
  upstash-mcp

Solución de problemas

Problemas comunes

Es posible que su cliente mcp tenga problemas para encontrar los binarios correctos debido a las diferencias entre su shell y el sistema PATH .

Para solucionar esto, puede obtener la ruta completa de los binarios ejecutando which npx o which docker en su shell y reemplazar el comando npx o docker en la configuración de MCP con la ruta binaria completa.

Administrador de versiones de nodos

Si utiliza un administrador de versiones de nodo como NVM o FNM, revise este problema . Debe cambiar el comando node en la configuración de MCP a la ruta absoluta del binario de nodo.

Solución de problemas adicionales

Consulta la guía de solución de problemas en la documentación de MCP. También puedes contactarnos en Discord .

Herramientas

Redis

redis_database_create_backup
redis_database_create_new
redis_database_delete
redis_database_delete_backup
redis_database_get_details
redis_database_list_backups
redis_database_list_databases
redis_database_reset_password
redis_database_restore_backup
redis_database_run_multiple_redis_commands
redis_database_run_single_redis_command
redis_database_set_daily_backup
redis_database_update_regions
redis_database_get_usage_last_5_days
redis_database_get_stats

Desarrollo

Clona el proyecto y ejecuta:

pnpm install
pnpm run watch

Esto construirá continuamente el proyecto y observará los cambios.

Para realizar pruebas, puede crear un archivo .env en el mismo directorio que el proyecto con el siguiente contenido:

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

Esto se usará para configurar Claude y ejecutar el inspector mcp.

Pruebas con Claude Desktop

Para instalar la configuración de Claude Desktop para el desarrollo local, ejecute el siguiente comando:

pnpm run setup

Esto agregará una entrada upstash a su archivo de configuración MCP que apunta a la compilación local del paquete.

{
  "upstash": {
    "command": "node",
    "args": ["<path-to-repo>/dist/index.js", "run", "<UPSTASH_EMAIL>", "<UPSTASH_API_KEY>"]
  }
}

NOTA: El mismo problema con el administrador de versiones de nodos se aplica aquí. Consulte la nota en la sección de uso si utiliza un administrador de versiones de nodos.

Ahora puedes usar Claude Desktop para ejecutar comandos Upstash.

Para ver los registros del servidor MCP en tiempo real, ejecute el siguiente comando:

pnpm run logs

Pruebas con MCP Inspector

También puede utilizar el Inspector MCP para probar las herramientas.

pnpm run inspector

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

El Protocolo de Contexto de Modelo (MCP) es un nuevo protocolo estandarizado para gestionar el contexto entre grandes modelos de lenguaje (LLM) y sistemas externos. En este repositorio, ofrecemos un instalador y un servidor MCP para las API de Upstash Developer.

Usage

Related Resources

Reddit Discussion about this server