image-mcp-server logo

image-mcp-server

by champierre

An MCP server that receives image URLs or local file paths and analyzes image content using the GPT-4o-mini model. It provides detailed analysis of the image content with high precision.

View on GitHub

Last updated: N/A

What is image-mcp-server?

This is an MCP server designed to analyze image content. It accepts image URLs or local file paths as input and uses the GPT-4o-mini model to provide a detailed analysis of the image.

How to use image-mcp-server?

The server can be installed via Smithery or manually. After installation, configure it with your OpenAI API key and add the server settings to your MCP configuration file (e.g., cline_mcp_settings.json or claude_desktop_config.json). Once configured, you can use the analyze_image and analyze_image_from_path tools with tools like Cline or Claude Desktop App.

Key features of image-mcp-server

  • Receives image URLs or local file paths as input

  • Provides detailed analysis of image content

  • High-precision image recognition and description using the GPT-4o-mini model

  • Image URL validity checking

  • Image loading from local files and Base64 encoding

Use cases of image-mcp-server

  • Analyzing images from URLs for content description

  • Analyzing local image files for content description

  • Integrating image analysis into AI assistants

  • Automated image content analysis for various applications

FAQ from image-mcp-server

What is an MCP server?

MCP stands for Multi-Client Protocol server. It allows different client applications to communicate with the same server using a standardized protocol.

Do I need an OpenAI API key?

Yes, you need an OpenAI API key to use the GPT-4o-mini model for image analysis.

How do I specify local file paths?

When using analyze_image_from_path, the AI assistant must specify a valid file path in the environment where the server is running. Path conversion between WSL and Windows may be necessary.

What if I see a type error during build?

A type error during build (e.g., TS7016) might occur due to missing TypeScript type definitions. This does not affect the server's execution, but you can resolve it by installing the type definition file as a development dependency.

How do I run the server in development mode?

You can run the server in development mode using the command npm run dev.