A
securityA
licenseA
qualityModel Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Last updated -
1
1,800
29
MIT License
Servidor MCP - Imagen
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para obtener y procesar imágenes de URL, rutas de archivos locales y matrices numpy. El servidor incluye una herramienta llamada fetch_images que devuelve imágenes como cadenas codificadas en base64 junto con sus tipos MIME.
Apóyanos
Si este proyecto te resulta útil y quieres apoyar proyectos futuros, ¡invítanos a un café! Tu apoyo nos ayuda a seguir desarrollando soluciones innovadoras de IA.
Sus contribuciones contribuyen en gran medida a alimentar nuestra pasión por crear aplicaciones inteligentes y fáciles de usar.
Tabla de contenido
Características
Obtener imágenes de URL (http/https)
Cargar imágenes desde rutas de archivos locales
Manejo especializado de imágenes locales de gran tamaño
Compresión automática de imágenes para imágenes grandes (>1 MB)
Procesamiento paralelo de múltiples imágenes
Asignación adecuada de tipos MIME para diferentes extensiones de archivo
Manejo y registro de errores integral
Prerrequisitos
Python 3.10+
gestor de paquetes uv (recomendado)
Instalación
Clonar este repositorio
Crear y activar un entorno virtual usando uv:
uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate
Instalar dependencias usando uv:
uv pip install -r requirements.txt
Ejecución del servidor
Hay dos formas de ejecutar el servidor MCP:
1. Método directo
Para iniciar el servidor MCP directamente:
uv run python mcp_image.py
2. Configurar para Windsurf/Cursor
Windsurf
Para agregar este servidor MCP a Windsurf:
Edite el archivo de configuración en ~/.codeium/windsurf/mcp_config.json
Agregue la siguiente configuración:
{
"mcpServers": {
"image": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
}
}
}
Cursor
Para agregar este servidor MCP a Cursor:
Abra Cursor y vaya a Configuración (Barra de navegación → Configuración del cursor)
Vaya a Características → Servidores MCP
Haga clic en + Agregar nuevo servidor MCP
Introduzca la siguiente configuración:
{
"mcpServers": {
"image": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
}
}
}
Herramientas disponibles
El servidor proporciona las siguientes herramientas:
fetch_images : obtiene y procesa imágenes desde URL o rutas de archivos locales Parámetros: image_sources: lista de URL o rutas de archivos a imágenes Devuelve: lista de imágenes procesadas con codificación base64 y tipos MIME
Ejemplos de uso
Ahora puedes usar comandos como:
"Obtener estas imágenes: [lista de URL o rutas de archivo]"
"Cargar y procesar esta imagen local: [ruta_del_archivo]"
Ejemplos
# URL-only test
[
"https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
"https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
"https://shigacare.fukushi.shiga.jp/mumeixxx/img/main.png"
]
# Mixed URL and local file test
[
"https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
"C:\\Users\\username\\Pictures\\image1.jpg",
"https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
"C:\\Users\\username\\Pictures\\image2.jpg"
]
Depuración
Si encuentra algún problema:
Compruebe que todas las dependencias estén instaladas correctamente
Verifique que el servidor esté ejecutándose y escuchando conexiones
Para problemas de carga de imágenes locales, asegúrese de que las rutas de los archivos sean correctas y accesibles
Para errores de "Tipo de imagen no compatible", verifique el manejo del tipo de contenido
Busque mensajes de error en la salida del servidor
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Un servidor de protocolo de contexto de modelo que permite obtener y procesar imágenes de URL, rutas de archivos locales y matrices numpy, y las devuelve como cadenas codificadas en base64 con tipos MIME adecuados.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides web content fetching and conversion capabilities.Last updated -4562MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that extracts images from URLs or base64 data and converts them into a format suitable for LLM analysis, allowing AI models to process and understand visual content.Last updated -34714MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that manages desktop images, providing functionality to count, list, and compress image files stored on the desktop.Last updated -303