Jasper AI

Um servidor MCP para interagir com a API do Jasper AI e gerar diversos tipos de conteúdo.

GitHub

Documentação

Protótipo do Servidor MCP Jasper AI

Este repositório contém um protótipo de servidor Model Context Protocol (MCP) para interagir com a API Jasper AI.

Configuração

Cursor/Windsurf

Para usar este servidor MCP Jasper com Windsurf, adicione a seguinte configuração ao seu arquivo mcp_config.json do Windsurf:

"jasper": {
  "command": "npx",
  "args": ["-y", "https://github.com/latecheckout/jasper-mcp-proto"],
  "env": {
    "JASPER_API_KEY": "YOUR_JASPER_API_KEY"
  }
}

Substitua YOUR_JASPER_API_KEY pela sua chave real da API Jasper.

Claude Desktop (Método Recomendado):

  1. Abra o aplicativo Claude Desktop.

  2. Navegue até Settings (ou Preferences).

  3. Vá para a aba Extensions.

  4. Baixe o arquivo jasper-mcp-prototype.dxt.

  5. Arraste e solte este arquivo na janela de extensões do Claude Desktop.

  6. Clique em Instalar

  7. Adicione sua chave da API Jasper no campo de configuração

  8. Ative a extensão usando o botão de alternância.

Build Local do Claude Desktop

O Claude Desktop pode ter problemas para executar servidores MCP com NPX, especialmente quando o node é gerenciado com nvm. Se você não conseguir instalar com o método acima, siga estes passos:

1. Pré-requisitos:

  • Certifique-se de ter o aplicativo Claude Desktop instalado. Estas instruções são adaptadas para o aplicativo desktop, pois a integração MCP baseada em navegador pode ser diferente.
  • Você precisará do Node.js e pnpm. Se não tiver o Node.js, instale-o a partir de nodejs.org. Você pode instalar o pnpm via npm: npm install -g pnpm.

2. Baixe e compile o Servidor MCP Jasper:

  • Clone este repositório (se ainda não o fez): 
    git clone https://github.com/latecheckout/jasper-mcp-proto.git
cd jasper-mcp-prototype
  • Instale as dependências: 
    pnpm install
  • Compile o projeto: 
    pnpm run build
    Isso criará um arquivo dist/index.js no diretório do projeto.

3. Obtenha os Caminhos de Arquivo Necessários:

  • Caminho do Executável do Node: Abra seu terminal e execute: 
    which node
    Copie o caminho completo exibido (por exemplo, /Users/yourusername/.nvm/versions/node/v18.17.0/bin/node ou /usr/local/bin/node).
  • Caminho Absoluto para dist/index.js: Navegue até o diretório raiz do jasper-mcp-prototype (se ainda não estiver lá). Em seguida, execute: 
    echo "$(pwd)/dist/index.js"
    Copie o caminho completo exibido (por exemplo, /Users/yourusername/path/to/jasper-mcp-prototype/dist/index.js).

4. Configure o Aplicativo Claude Desktop:

  • Abra seu aplicativo Claude Desktop.

  • Vá para Settings (ou Preferências).

  • Encontre a aba ou seção Developer.

  • Clique em Edit Config (ou uma opção com nome semelhante para editar a configuração do servidor MCP). Isso abrirá um arquivo de configuração JSON (geralmente chamado claude_desktop_config.json ou similar) em um editor de texto.

  • Adicione ou modifique o objeto mcpServers neste arquivo. Se mcpServers não existir, você pode adicionar toda a estrutura. Se existir, adicione jasper-ai como uma nova chave dentro dele:

    {
  "mcpServers": {
    ...
    "jasper": {
      "command": "PASTE_YOUR_NODE_EXECUTABLE_PATH_HERE",
      "args": ["PASTE_YOUR_ABSOLUTE_PATH_TO_DIST/INDEX.JS_HERE"],
      "env": {
        "JASPER_API_KEY": "YOUR_JASPER_API_KEY_HERE"
      }
    }
  }
}

Importante:

  • Substitua "PASTE_YOUR_NODE_EXECUTABLE_PATH_HERE" pelo caminho do executável do Node que você copiou no passo 3a.
  • Substitua "PASTE_YOUR_ABSOLUTE_PATH_TO_DIST/INDEX.JS_HERE" pelo caminho absoluto para dist/index.js que você copiou no passo 3b.
  • Substitua "YOUR_JASPER_API_KEY_HERE" pela sua chave real da API Jasper.
  • Certifique-se de que o arquivo resultante seja JSON válido. Se você estiver adicionando jasper a um objeto mcpServers existente, certifique-se de adicionar uma vírgula após a entrada do servidor anterior, se necessário.

5. Reinicie o Claude:

  • Salve as alterações no arquivo de configuração.
  • Feche completamente e reinicie o aplicativo Claude Desktop para que a nova configuração do servidor MCP entre em vigor.

Agora você deve ser capaz de usar as ferramentas MCP Jasper através deste servidor MCP local no Claude.

Uso

Uma vez configurado corretamente em seu ambiente, você pode pedir ao LLM para usar o jasper para escrever conteúdo para você. Por exemplo:

Use jasper to write a blog post about the latest trends in AI. Pick an appropriate tone, and audience.

Instalação

  1. Clone o repositório:

    git clone <your-repository-url>
cd jasper-mcp

  2. Instale as dependências: Este projeto usa pnpm como gerenciador de pacotes.

    pnpm install

Fluxo de Desenvolvimento

pnpm run dev

  • Execute em modo de desenvolvimento: Este comando inicia o servidor e usa @modelcontextprotocol/inspector. Você pode usar o inspetor para testar o servidor MCP.

  • Nota: Não há recarregamento automático. Após fazer alterações no código, você precisará executar pnpm build e depois clicar no botão de reiniciar no inspetor MCP para ver suas alterações.

Ferramentas e Recursos

Este servidor MCP fornece as seguintes ferramentas e recursos:

Ferramentas

  1. generate-content:

    • Descrição: Gere conteúdo via Jasper AI. Jasper é um marketing generativo premium com o guia de estilo, vozes de marca e públicos do usuário. Jasper pode ser usado para aplicar estilos ou gerar conteúdo para o usuário que corresponda ao seu guia de estilo, vozes de marca e públicos.
    • Veja src/tools/generateContent.ts.

  2. apply-style:

    • Descrição: Aplica as regras de um guia de estilo especificado ao conteúdo de texto fornecido e retorna o conteúdo estilizado. Esta ferramenta pode ser usada para garantir que o conteúdo esteja em conformidade com o guia de estilo do usuário, especialmente útil ao gerar conteúdo para o público ou para públicos específicos.
    • Veja src/tools/applyStyleTool.ts.

  3. get-jasper-style-guides:

    • Descrição: Retorna o id do guia de estilo pertencente ao usuário. Este id de guia de estilo pode ser passado para a ferramenta de geração de conteúdo do jasper para usar esse estilo ao criar conteúdo. Também pode ser usado na ferramenta de aplicação de estilo para aplicar um estilo a um texto fornecido.
    • Veja src/tools/getStyleGuides.ts.

  4. get-jasper-brand-voices:

    • Descrição: Retorna uma lista das vozes/tons de marca pertencentes ao usuário. Essas vozes de marca incluem uma descrição para ajudar o LLM e/ou o usuário a escolher um tom apropriado, e um toneId que pode ser passado para a ferramenta de geração de conteúdo do jasper para usar essa voz/tom de marca ao criar conteúdo.
    • Veja src/tools/getBrandVoices.ts.

  5. get-jasper-audiences:

    • Descrição: Retorna uma lista dos públicos pertencentes ao usuário. Esses públicos incluem uma descrição para ajudar o LLM e/ou o usuário a escolher um público apropriado, e um audienceId que pode ser passado para a ferramenta de geração de conteúdo do jasper para usar esse público ao criar conteúdo.
    • Veja src/tools/getAudiences.ts.

Recursos

  1. jasper://styles (Registrado como jasper-styles):

    • Busca os estilos disponíveis do Jasper AI.
    • Implementação: src/resources/getStyles.ts

  2. jasper://brandvoices (Registrado como jasper-brand-voices):

    • Busca as vozes de marca (tons) disponíveis do Jasper AI.
    • Implementação: src/resources/getBrandVoices.ts

  3. jasper://audiences (Registrado como jasper-audiences):

    • Busca os públicos disponíveis do Jasper AI.
    • Implementação: src/resources/getAudiences.ts