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.