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í .

Related MCP server: Memex

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