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
Prerrequisitos
Instalación
Ejecución del servidor
- Método directo
- Configurar para Windsurf/Cursor
Herramientas disponibles
- Ejemplos de uso
Depuración
Contribuyendo
Licencia

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.

MCP Image Server

Integrations