YourImageShare MCP

yourimageshare-mcp

Servidor MCP (Model Context Protocol) para YourImageShare. Construido para agentes de codificación con IA (Claude Code, Cursor y otras herramientas compatibles con MCP): pega una captura de pantalla en un informe de error, una descripción de PR o un hilo de soporte como una URL real en lugar de un blob base64 o un paso de carga manual. Funciona de la misma manera con Claude Desktop y cualquier otro cliente MCP.

• Obtén una clave de API: inicia sesión y abre la pestaña API en yourimageshare.com/my-account.
• Referencia HTTP completa: yourimageshare.com/about/api.
• Especificación OpenAPI 3.1: yourimageshare.com/openapi.json, si tu herramienta la prefiere a este README.

Instalar / ejecutar

No se necesita instalación: ejecuta directamente con npx:

npx yourimageshare-mcp

También está listado en Smithery, si tu cliente MCP instala desde allí.

Configuración de Claude Desktop / Claude Code

Agrega a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "yourimageshare": {
      "command": "npx",
      "args": ["-y", "yourimageshare-mcp"],
      "env": {
        "YIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Variables de entorno

Variable	Requerida	Propósito
YIS_API_KEY	sí	Tu clave de API de YourImageShare.
YIS_BASE_URL	no	Anula la URL base de la API (por defecto https://yourimageshare.com/api). Solo para pruebas.

Herramientas

upload_image

Sube un archivo. Proporciona cualquiera de:

• path - una ruta de archivo local que este proceso de servidor pueda leer, o
• base64 + filename - contenido de archivo en línea, para clientes MCP sin acceso al sistema de archivos local.

Opcional expiresIn (segundos, de 60 a 2,592,000 = 30 días) elimina automáticamente la carga más tarde. Devuelve la misma forma JSON que la respuesta de carga de la API HTTP (id, type, path, src, direct, expires_at).

list_uploads

Opcional page (por defecto 1, 50 por página). Devuelve tus cargas de la más reciente a la más antigua.

delete_upload

Requiere id (de upload_image/list_uploads). Elimina permanentemente la carga.

Notas

• Este servidor solo actúa como la cuenta vinculada a YIS_API_KEY: no hay forma de que un agente conectado actúe como cualquier otra cuenta.
• Los errores de la API (clave incorrecta, límite de velocidad, archivo rechazado por moderación, etc.) se devuelven como un resultado de error de herramienta con el mensaje propio de la API, no como una llamada de herramienta fallida.
• Está construido como un cliente pequeño y autónomo en lugar de depender del paquete npm separado yourimageshare, para que los lanzamientos de este servidor no estén acoplados a los de ese paquete.

Licencia

MIT

Soporte

yourimageshare.com/contact