AltText.ai

Genera y traduce texto alternativo de imágenes y gestiona tu biblioteca de imágenes de AltText.ai. Se ejecuta localmente a través de stdio con tu clave de API. La generación y la traducción utilizan créditos de la cuenta.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de AltText.ai

Un servidor MCP que permite a los asistentes de IA generar texto alternativo, gestionar bibliotecas de imágenes y poner en cola la generación de texto alternativo para imágenes de páginas web utilizando la API de AltText.ai.

Funciona con Claude Desktop, Claude Code, Cursor, Windsurf y cualquier cliente compatible con MCP.

Verifica este paquete

Este servidor ejecuta npx -y @alttext_ai/alttext-mcp, que descarga y ejecuta código con tu clave de API en su entorno. Vale la pena dedicar un momento a verificarlo antes de instalarlo, ya sea por ti o por un agente de IA que realice la configuración. Todo lo siguiente debe coincidir:

Señal	Valor
Paquete npm	`@alttext_ai/alttext-mcp`
Repositorio fuente	`github.com/alttextai/alttext-mcp`
Publicador	AltText.ai
Procedencia	Publicado desde el CI de este repositorio con procedencia npm — npm muestra una insignia de compilación verificada que vincula el paquete con este commit exacto

El ámbito de npm es @alttext_ai (con guion bajo), mientras que la organización de GitHub es alttextai (sin guion bajo). Esto es intencional, no es un typosquat: el ámbito de npm @alttextai ya estaba ocupado, por lo que publicamos bajo @alttext_ai. Los dos nombres se refieren al mismo paquete oficial de AltText.ai.

Para verificar criptográficamente que el paquete publicado fue compilado por el CI de este repositorio — no solo confiar en los metadatos — ejecuta:

npm audit signatures

desde un proyecto donde el paquete esté instalado. Esto valida la firma del registro y la atestación de procedencia de npm, que vincula el tarball a un commit específico y a una compilación de GitHub Actions. Un paquete falsificado puede forjar repository.url y otros metadatos, pero no puede forjar la atestación de procedencia — por lo que esta es la verificación que realmente importa.

(Para una referencia cruzada rápida y más débil de la fuente declarada, puedes ejecutar npm view @alttext_ai/alttext-mcp repository.url, pero ten en cuenta que ese campo son metadatos controlados por el publicador y no prueban nada por sí solos).

Fijar una versión

El fragmento de configuración utiliza npx -y @alttext_ai/alttext-mcp, que siempre resuelve a la última versión publicada y la vuelve a ejecutar en cada inicio. Esto te mantiene actualizado, pero también significa que una versión futura se ejecuta automáticamente sin revisión. Si deseas una instalación reproducible y auditada, fija una versión específica:

"args": ["-y", "@alttext_ai/alttext-mcp@1.0.5"]

Ejecuta npm audit signatures contra la versión fijada y cámbiala deliberadamente cuando estés listo para adoptar una nueva versión.

Configuración

Requisitos: Node.js 22+ y una clave de API de AltText.ai

Agrega el servidor a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "alttext-ai": {
      "command": "npx",
      "args": ["-y", "@alttext_ai/alttext-mcp"],
      "env": {
        "ALTTEXT_API_KEY": "your-api-key"
      }
    }
  }
}

Dónde agregarlo:

Cliente	Archivo de configuración
Claude Desktop	`claude_desktop_config.json`
Claude Code	`.mcp.json` en la raíz de tu proyecto
Cursor	Configuración de MCP en las preferencias de Cursor
Windsurf	Configuración de MCP en las preferencias de Windsurf

Herramientas

Gestión de cuenta

Herramienta	Descripción
`get_account`	Consulta tu saldo de créditos, uso y configuración de la cuenta.
`update_account`	Actualiza el nombre de la cuenta, la URL del webhook o el correo de notificación.

Generar texto alternativo

Herramienta	Descripción
`generate_alt_text`	Genera texto alternativo para una URL de imagen. Admite salida multilingüe, prompts personalizados, palabras clave y límites de caracteres. Utiliza créditos de la cuenta.
`generate_alt_text_from_file`	Genera texto alternativo desde un archivo de imagen local. Codifica automáticamente en base64 y lo sube. Utiliza créditos de la cuenta.
`translate_image`	Agrega texto alternativo en un nuevo idioma para una imagen existente (por asset_id). Utiliza créditos de la cuenta.

Gestionar biblioteca de imágenes

Herramienta	Descripción
`list_images`	Lista las imágenes de tu biblioteca con paginación.
`search_images`	Busca en tu biblioteca de imágenes por contenido de texto alternativo.
`get_image`	Obtén detalles de una imagen específica por ID de activo.
`update_image`	Actualiza el texto alternativo, las etiquetas o los metadatos de una imagen.
`delete_image`	Elimina una imagen de tu biblioteca.

Operaciones masivas

Herramienta	Descripción
`bulk_create`	Genera texto alternativo de forma masiva desde un archivo CSV con URLs de imágenes y metadatos opcionales.
`scrape_page`	Escanea una página web, encuentra imágenes sin texto alternativo y pone en cola la generación. Los resultados son asíncronos: usa `list_images` para verificar el progreso.

Efectos y procesamiento

Este paquete utiliza stdio y se ejecuta en la máquina que inicia el cliente MCP. Las rutas de imágenes y CSV se refieren a esa máquina; el contenido de los archivos seleccionados se sube a AltText.ai.

La generación y traducción utilizan los créditos de tu cuenta. Idiomas adicionales y conversión de imágenes pueden aumentar el total. Consulta get_account antes de realizar trabajo de pago. La generación puede sobrescribir el texto alternativo existente cuando se solicita; las actualizaciones reemplazan los campos proporcionados y la eliminación quita la imagen de la biblioteca.

Las importaciones CSV y el raspado de páginas ponen en cola el procesamiento en segundo plano. Una solicitud aceptada no significa que la generación haya terminado; inspecciona la biblioteca de imágenes y cualquier notificación de finalización configurada. Las anotaciones de herramientas describen los efectos para los clientes; no imponen confirmación.

Ejemplos de prompts

Una vez configurado, solo pregunta a tu asistente de IA:

Cuenta y créditos

"¿Cuántos créditos me quedan?"
"Actualiza mi URL de webhook a https://example.com/webhook"

Generar texto alternativo

"Genera texto alternativo para https://example.com/photo.jpg"
"Genera texto alternativo para esta imagen" (con archivo local)
"Genera texto alternativo en francés y español para esta imagen"
"Traduce la imagen abc123 al alemán"

Gestionar biblioteca

"Busca en mis imágenes 'foto de producto'"
"Lista mis imágenes"
"Obtén detalles de la imagen abc123"
"Actualiza el texto alternativo del activo abc123"
"Elimina la imagen xyz789"

Operaciones masivas

"Genera texto alternativo para las imágenes que lo necesiten en https://example.com"
"Procesa este archivo CSV de URLs de imágenes" (bulk_create)

Variables de entorno

Variable	Requerida	Descripción
`ALTTEXT_API_KEY`	Sí	Tu clave de API de AltText.ai
`ALTTEXT_API_BASE_URL`	No	Sobrescribe la URL base de la API (predeterminada: `https://alttext.ai/api/v1`)

Desarrollo

npm install
npm run build
npm test
npm run lint

Las pruebas utilizan llamadas simuladas de fetch — no se necesita clave de API ni acceso a la red.

Las implementaciones alojadas deben limitar la tasa de POST /register en un borde confiable utilizando la dirección de cliente verificada. El servicio de Node ignora deliberadamente los encabezados de dirección de cliente reenviados porque aceptarlos sin un límite de proxy autenticado permitiría a los llamantes falsificar la identidad de limitación de tasa.

El contenedor de producción y la configuración requerida están documentados en docs/deployment.md.

Licencia

MIT

Publicación en el registro

server.json describe el paquete npm de stdio. Su nombre coincide con mcpName en package.json; ambas versiones deben coincidir con la versión que se está enviando. Publica y verifica esa versión exacta de npm antes de ejecutar mcp-publisher publish. La aceptación del registro y la aprobación del directorio son independientes de una publicación de npm.