YourImageShare MCP
Sube, lista y elimina archivos en YourImageShare: alojamiento gratuito de imágenes y videos, límite de 200MB, sin necesidad de cuenta, desde Claude, ChatGPT o cualquier agente compatible con MCP.
Documentación
yourimageshare-mcp
Servidor MCP (Model Context Protocol) para YourImageShare. Permite que un agente de IA compatible con MCP (Claude Desktop, Claude Code y otros clientes MCP) suba, liste y elimine archivos en YourImageShare directamente: «sube esta captura de pantalla y dame un enlace» como una llamada de herramienta en lugar de un bucle manual de copiar-pegar-subir.
- 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.
Instalación / ejecución
No se necesita instalación: ejecútalo directamente con npx:
npx yourimageshare-mcp
También está listado en Smithery, si tu cliente MCP instala desde allí en su lugar.
Configuración de Claude Desktop / Claude Code
Añádelo a la configuración de tu cliente MCP (p. ej. claude_desktop_config.json):
{
"mcpServers": {
"yourimageshare": {
"command": "npx",
"args": ["-y", "yourimageshare-mcp"],
"env": {
"YIS_API_KEY": "YOUR_API_KEY"
}
}
}
}
Variables de entorno
| Variable | Obligatoria | Propósito |
|---|---|---|
YIS_API_KEY | sí | Tu clave de API de YourImageShare. |
YIS_BASE_URL | no | Sobrescribe la URL base de la API (por defecto https://yourimageshare.com/api). Solo para pruebas. |
Herramientas
upload_image
Sube un archivo. Proporciona una de las dos opciones:
path- una ruta de archivo local que este proceso del servidor pueda leer, obase64+filename- contenido de archivo en línea, para clientes MCP sin acceso al sistema de archivos local.
El expiresIn opcional (segundos, de 60 a 2.592.000 = 30 días) elimina automáticamente la subida más tarde. Devuelve la misma forma JSON que la respuesta de subida de la API HTTP (id, type, path, src, direct, expires_at).
list_uploads
El page opcional (por defecto 1, 50 por página). Devuelve tus subidas de la más reciente a la más antigua.
delete_upload
Requiere id (de upload_image/list_uploads). Elimina permanentemente la subida.
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 resultado de error de herramienta con el mensaje propio de la API, no como una llamada de herramienta fallida.
- Construido como un cliente pequeño e independiente 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