Jasper AI

Un servidor MCP para interactuar con la API de Jasper AI y generar varios tipos de contenido.

GitHub

Documentación

Prototipo de Servidor MCP de Jasper AI

Este repositorio contiene un prototipo de servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Jasper AI.

Configuración

Cursor/Windsurf

Para usar este servidor MCP de Jasper con Windsurf, añade la siguiente configuración a tu archivo mcp_config.json de Windsurf:

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

Reemplaza YOUR_JASPER_API_KEY con tu clave real de la API de Jasper.

Claude Desktop (Método Recomendado):

  1. Abre la aplicación de Claude Desktop.

  2. Navega a Settings (o Preferences).

  3. Ve a la pestaña de Extensions.

  4. Descarga el archivo jasper-mcp-prototype.dxt.

  5. Arrastra y suelta este archivo en la ventana de extensiones de Claude Desktop.

  6. Haz clic en Instalar

  7. Añade tu clave de API de Jasper en el campo de configuración

  8. Habilita la extensión usando el interruptor.

Compilación Local de Claude Desktop

Claude Desktop puede tener problemas para ejecutar servidores MCP con NPX, especialmente cuando node se gestiona con nvm. Si no puedes instalar con el método anterior, sigue estos pasos:

1. Requisitos previos:

  • Asegúrate de tener instalada la aplicación de escritorio de Claude Desktop. Estas instrucciones están adaptadas para la aplicación de escritorio, ya que la integración MCP basada en navegador podría diferir.
  • Necesitarás Node.js y pnpm. Si no tienes Node.js, instálalo desde nodejs.org. Puedes instalar pnpm a través de npm: npm install -g pnpm.

2. Descargar y compilar el servidor MCP de Jasper:

  • Clona este repositorio (si aún no lo has hecho): 
    git clone https://github.com/latecheckout/jasper-mcp-proto.git
cd jasper-mcp-prototype
  • Instala las dependencias: 
    pnpm install
  • Compila el proyecto: 
    pnpm run build
    Esto creará un archivo dist/index.js en el directorio del proyecto.

3. Obtener las rutas de archivo necesarias:

  • Ruta del ejecutable de Node: Abre tu terminal y ejecuta: 
    which node
    Copia la ruta completa mostrada (por ejemplo, /Users/yourusername/.nvm/versions/node/v18.17.0/bin/node o /usr/local/bin/node).
  • Ruta absoluta a dist/index.js: Navega al directorio raíz de jasper-mcp-prototype (si aún no estás allí). Luego ejecuta: 
    echo "$(pwd)/dist/index.js"
    Copia la ruta completa mostrada (por ejemplo, /Users/yourusername/path/to/jasper-mcp-prototype/dist/index.js).

4. Configurar la aplicación de Claude Desktop:

  • Abre tu aplicación de Claude Desktop.

  • Ve a Settings (o Preferencias).

  • Encuentra la pestaña o sección de Developer.

  • Haz clic en Edit Config (o una opción con nombre similar para editar la configuración del servidor MCP). Esto abrirá un archivo de configuración JSON (a menudo llamado claude_desktop_config.json o similar) en un editor de texto.

  • Añade o modifica el objeto mcpServers en este archivo. Si mcpServers no existe, puedes añadir toda la estructura. Si existe, añade jasper-ai como una nueva clave dentro de él:

    {
  "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:

  • Reemplaza "PASTE_YOUR_NODE_EXECUTABLE_PATH_HERE" con la ruta del ejecutable de Node que copiaste en el paso 3a.
  • Reemplaza "PASTE_YOUR_ABSOLUTE_PATH_TO_DIST/INDEX.JS_HERE" con la ruta absoluta a dist/index.js que copiaste en el paso 3b.
  • Reemplaza "YOUR_JASPER_API_KEY_HERE" con tu clave real de la API de Jasper.
  • Asegúrate de que el archivo resultante sea JSON válido. Si estás añadiendo jasper a un objeto mcpServers existente, asegúrate de añadir una coma después de la entrada del servidor anterior si es necesario.

5. Reiniciar Claude:

  • Guarda los cambios en el archivo de configuración.
  • Cierra y reinicia completamente la aplicación de Claude Desktop para que la nueva configuración del servidor MCP surta efecto.

Ahora deberías poder usar las herramientas MCP de Jasper a través de este servidor MCP local en Claude.

Uso

Una vez configurado correctamente en tu entorno, puedes pedirle al LLM que use jasper para escribir contenido por ti. Por ejemplo:

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

Instalación

  1. Clonar el repositorio:

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

  2. Instalar dependencias: Este proyecto usa pnpm como gestor de paquetes.

    pnpm install

Flujo de Desarrollo

pnpm run dev

  • Ejecutar en modo de desarrollo: Este comando inicia el servidor y usa @modelcontextprotocol/inspector. Puedes usar el inspector para probar el servidor MCP.

  • Nota: No hay recarga en caliente. Después de hacer cambios en el código, necesitarás ejecutar pnpm build y luego hacer clic en el botón de reinicio en el inspector de MCP para ver tus cambios.

Herramientas y Recursos

Este servidor MCP proporciona las siguientes herramientas y recursos:

Herramientas

  1. generate-content:

    • Descripción: Genera contenido a través de Jasper AI. Jasper es un generador de marketing premium con la guía de estilo, voces de marca y audiencias del usuario. Jasper se puede usar para aplicar estilos o generar contenido para el usuario que coincida con su guía de estilo, voces de marca y audiencias.
    • Ver src/tools/generateContent.ts.

  2. apply-style:

    • Descripción: Aplica las reglas de una guía de estilo especificada al contenido de texto proporcionado y devuelve el contenido con estilo aplicado. Esta herramienta se puede usar para asegurar que el contenido se ajuste a la guía de estilo del usuario, especialmente útil al generar contenido para el público o para audiencias específicas.
    • Ver src/tools/applyStyleTool.ts.

  3. get-jasper-style-guides:

    • Descripción: Devuelve el id de la guía de estilo perteneciente al usuario. Este id de guía de estilo se puede pasar a la herramienta de generación de contenido de jasper para usar ese estilo al crear contenido. También se puede usar en la herramienta de aplicar estilo para aplicar un estilo a un texto dado.
    • Ver src/tools/getStyleGuides.ts.

  4. get-jasper-brand-voices:

    • Descripción: Devuelve una lista de las voces/tonos de marca pertenecientes al usuario. Estas voces de marca incluyen una descripción para ayudar al LLM y/o al usuario a elegir un tono apropiado, y un toneId que se puede pasar a la herramienta de generación de contenido de jasper para usar esa voz/tono de marca al crear contenido.
    • Ver src/tools/getBrandVoices.ts.

  5. get-jasper-audiences:

    • Descripción: Devuelve una lista de las audiencias pertenecientes al usuario. Estas audiencias incluyen una descripción para ayudar al LLM y/o al usuario a elegir una audiencia apropiada, y un audienceId que se puede pasar a la herramienta de generación de contenido de jasper para usar esa audiencia al crear contenido.
    • Ver src/tools/getAudiences.ts.

Recursos

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

    • Obtiene los estilos disponibles de Jasper AI.
    • Implementación: src/resources/getStyles.ts

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

    • Obtiene las voces de marca (tonos) disponibles de Jasper AI.
    • Implementación: src/resources/getBrandVoices.ts

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

    • Obtiene las audiencias disponibles de Jasper AI.
    • Implementación: src/resources/getAudiences.ts