Momento MCP Server

Un servidor MCP que proporciona una interfaz simple para el servicio de caché sin servidores de Momento.

Documentación

Servidor MCP de Momento

Una implementación simple del Protocolo de Contexto de Modelo (MCP) para Momento Cache.

Disponible en npmjs como @gomomento/mcp-momento

Herramientas

  • get
    • Obtiene el valor de caché almacenado para la clave dada.
    • Entradas:
      • key cadena -- la clave a buscar en la caché.
      • cacheName cadena -- el nombre de la caché donde reside la clave (opcional)
    • Devuelve:
      • Hit con el valor encontrado si la clave fue encontrada.
      • Miss si la clave no fue encontrada.
      • Error si la solicitud falló.
  • set
    • Establece el valor en la caché con un Tiempo de Vida (TTL) dado en segundos. Si ya existe un valor para esta clave, será reemplazado por el nuevo valor independientemente del tipo de datos del valor anterior.
    • Entradas:
      • key: cadena -- la clave a establecer en la caché
      • value: cadena -- el valor a establecer para la clave dada
      • ttl: entero -- el número de segundos para mantener este valor en la caché (opcional)
      • cacheName: cadena -- el nombre de la caché donde almacenar la clave (opcional)
    • Devuelve:
      • Success si la clave fue escrita exitosamente en la caché.
      • Error si la solicitud falló.
  • list-caches
    • Lista los nombres de todas las cachés en tu cuenta de Momento.
    • Entradas:
      • (ninguna)
    • Devuelve:
      • Success con una lista separada por comas de los nombres de las cachés
      • Error si la solicitud falló
  • create-cache
    • Crea una nueva caché en tu cuenta de Momento
    • Entradas:
      • name: cadena - el nombre de la caché a crear
    • Devuelve:
      • Success si la caché fue creada exitosamente
      • Error si la solicitud falló
  • delete-cache
    • Elimina una caché de tu cuenta de Momento
    • Entradas:
      • name: cadena - el nombre de la caché a eliminar
    • Devuelve:
      • Success si la caché fue eliminada exitosamente
      • Error si la solicitud falló

Inicio rápido

  1. Obtén una clave de API de Momento desde la Consola de Momento. Nota - para ejecutar herramientas del plano de control (list-caches, create-cache, delete-cache), debes usar una clave de API de super usuario.

  2. Establece variables de entorno para configurar el nombre de la caché y el Tiempo de Vida (TTL) para los elementos en la caché.

    # required
    export MOMENTO_API_KEY="your-api-key"
    
    # optional
    export MOMENTO_CACHE_NAME="your-cache-name"
    export DEFAULT_TTL_SECONDS=60
    

Si no estableces estos valores, se usará mcp-momento como nombre de la caché y 60 seconds como tiempo de vida predeterminado.

Uso con MCP Inspector

npx -y @modelcontextprotocol/inspector npx @gomomento/mcp-momento@latest

Uso con NPX en Claude Desktop

Nota: si estás usando nodenv, reemplaza el npx simple con la ruta a tu binario npx (por ejemplo, /Users/username/.nodenv/shims/npx).

{
  "mcpServers": {
    "momento": {
      "command": "npx",
      "args": [
        "-y",
        "@gomomento/mcp-momento"
      ],
      "env": {
        "MOMENTO_API_KEY": "your-api-key",
        "MOMENTO_CACHE_NAME": "your-cache-name",
        "DEFAULT_TTL_SECONDS": 60
      }
    }
  }
}

Configuración para desarrollo local

  1. Instala las dependencias:

    npm install
    
  2. Compila el servidor:

    npm run build
    
  3. Ejecuta con MCP Inspector

    export MOMENTO_API_KEY="your-api-key"
    npx @modelcontextprotocol/inspector node dist/index.js