Imágenes de lectura de MCP

Un servidor MCP para analizar imágenes con modelos de visión de OpenRouter. Este servidor proporciona una interfaz sencilla para analizar imágenes con diversos modelos de visión, como Claude-3.5-sonnet y Claude-3-opus, a través de la API de OpenRouter.

Instalación

npm install @catalystneuro/mcp_read_images

Related MCP server: vision-mcp

Configuración

El servidor requiere una clave API de OpenRouter. Puedes obtenerla en OpenRouter .

Agregue el servidor a su archivo de configuración de MCP (generalmente ubicado en ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json para VSCode):

{
  "mcpServers": {
    "read_images": {
      "command": "read_images",
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "OPENROUTER_MODEL": "anthropic/claude-3.5-sonnet"  // optional, defaults to claude-3.5-sonnet
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

El servidor proporciona una única herramienta, analyze_image que se puede utilizar para analizar imágenes:

// Basic usage with default model
use_mcp_tool({
  server_name: "read_images",
  tool_name: "analyze_image",
  arguments: {
    image_path: "/path/to/image.jpg",
    question: "What do you see in this image?"  // optional
  }
});

// Using a specific model for this call
use_mcp_tool({
  server_name: "read_images",
  tool_name: "analyze_image",
  arguments: {
    image_path: "/path/to/image.jpg",
    question: "What do you see in this image?",
    model: "anthropic/claude-3-opus-20240229"  // overrides default and settings
  }
});

Selección de modelos

El modelo se selecciona en el siguiente orden de precedencia:

1. Modelo especificado en la llamada a la herramienta (argumento model )

2. Modelo especificado en la configuración de MCP (variable de entorno OPENROUTER_MODEL )

3. Modelo por defecto (antrópico/claude-3.5-sonnet)

Modelos compatibles

Se han probado los siguientes modelos de OpenRouter:

• antrópico/claude-3.5-soneto

• antrópico/claude-3-opus-20240229

Características

• Optimización y cambio de tamaño automático de imágenes

• Selección de modelo configurable

• Soporte para preguntas personalizadas sobre imágenes

• Mensajes de error detallados

• Conversión automática de JPEG y optimización de calidad

Manejo de errores

El servidor maneja varios casos de error:

• Rutas de imagen no válidas

• Claves API faltantes

• Errores de red

• Selecciones de modelo no válidas

• Errores de procesamiento de imágenes

Cada error devolverá un mensaje descriptivo para ayudar a diagnosticar el problema.

Desarrollo

Para construir desde la fuente:

git clone https://github.com/catalystneuro/mcp_read_images.git
cd mcp_read_images
npm install
npm run build

Licencia

Licencia MIT. Consulte LICENCIA para más detalles.