Momento MCP Server

Um servidor MCP que fornece uma interface simples para o serviço de cache serverless da Momento.

Documentação

Momento MCP Server

Uma implementação simples de servidor Model Context Protocol (MCP) para Momento Cache.

Disponível no npmjs como @gomomento/mcp-momento

Ferramentas

  • get
    • Obtém o valor do cache armazenado para a chave fornecida.
    • Entradas:
      • key string -- a chave a ser procurada no cache.
      • cacheName string -- o nome do cache onde a chave reside (opcional)
    • Retornos:
      • Hit com o valor encontrado se a chave foi encontrada.
      • Miss se a chave não foi encontrada.
      • Error se a solicitação falhou.
  • set
    • Define o valor no cache com um determinado Time To Live (TTL) em segundos. Se um valor para esta chave já estiver presente, ele será substituído pelo novo valor, independentemente do tipo de dados do valor anterior.
    • Entradas:
      • key: string -- a chave a ser definida no cache
      • value: string -- o valor a ser definido para a chave fornecida
      • ttl: inteiro -- o número de segundos para manter este valor no cache (opcional)
      • cacheName: string -- o nome do cache para armazenar a chave (opcional)
    • Retornos:
      • Success se a chave foi gravada com sucesso no cache.
      • Error se a solicitação falhou.
  • list-caches
    • Lista os nomes de todos os caches na sua conta Momento.
    • Entradas:
      • (nenhuma)
    • Retornos:
      • Success com uma lista separada por vírgulas dos nomes dos caches
      • Error se a solicitação falhou
  • create-cache
    • Cria um novo cache na sua conta Momento
    • Entradas:
      • name: string - o nome do cache a ser criado
    • Retornos:
      • Success se o cache foi criado com sucesso
      • Error se a solicitação falhou
  • delete-cache
    • Exclui um cache da sua conta Momento
    • Entradas:
      • name: string - o nome do cache a ser excluído
    • Retornos:
      • Success se o cache foi excluído com sucesso
      • Error se a solicitação falhou

Início rápido

  1. Obtenha uma chave de API Momento no Momento Console. Nota - para executar ferramentas de plano de controle (list-caches, create-cache, delete-cache), você deve usar uma chave de API de super usuário.

  2. Defina variáveis de ambiente para configurar o nome do cache e o Time To Live (TTL) para itens no cache.

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

Se você não definir esses valores, ele usará mcp-momento como nome do cache e 60 seconds para o tempo de vida padrão.

Uso com o MCP Inspector

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

Uso com NPX no Claude Desktop

Nota: se você estiver usando nodenv, substitua o npx simples pelo caminho para o seu binário npx (por exemplo, /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
      }
    }
  }
}

Configuração para desenvolvimento local

  1. Instale as dependências:

    npm install
    
  2. Compile o servidor:

    npm run build
    
  3. Execute com o MCP Inspector

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