image-mcp-server
[ README](README.ja.md)
[](https://smithery.ai/server/@champierre/image-mcp-server)
An MCP server that receives image URLs or local file paths and analyzes image content using the GPT-4o-mini model.
Features
- Receives image URLs or local file paths as input and provides detailed analysis of the 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
Installation
Installing via Smithery
To install Image Analysis Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@champierre/image-mcp-server):
Manual Installation
Configuration
To use this server, you need an OpenAI API key. Set the following environment variable:
MCP Server Configuration
To use with tools like Cline, add the following settings to your MCP server configuration file:
For Cline
Add the following to `cline_mcp_settings.json`:
For Claude Desktop App
Add the following to `claude_desktop_config.json`:
Usage
Once the MCP server is configured, the following tools become available:
- `analyze_image`: Receives an image URL and analyzes its content.
- `analyze_image_from_path`: Receives a local file path and analyzes its content.
Usage Examples
**Analyzing from URL:**
**Analyzing from local file path:**
Note: Specifying Local File Paths
When using the `analyze_image_from_path` tool, the AI assistant (client) must specify a **valid file path in the environment where this server is running**.
- **If the server is running on WSL:** - If the AI assistant has a Windows path (e.g., `C:\...`), it needs to convert it to a WSL path (e.g., `/mnt/c/...`) before passing it to the tool. - If the AI assistant has a WSL path, it can pass it as is.
- **If the server is running on Windows:** - If the AI assistant has a WSL path (e.g., `/home/user/...`), it needs to convert it to a UNC path (e.g., `\\wsl$\Distro\...`) before passing it to the tool. - If the AI assistant has a Windows path, it can pass it as is.
**Path conversion is the responsibility of the AI assistant (or its execution environment).** The server will try to interpret the received path as is.
Note: Type Errors During Build
When running `npm run build`, you may see an error (TS7016) about missing TypeScript type definitions for the `mime-types` module.
This is a type checking error, and since the JavaScript compilation itself succeeds, it **does not affect the server's execution**. If you want to resolve this error, install the type definition file as a development dependency.
Development
License
MIT