Image MCP Server

🚀 Image Analysis MCP Server

An MCP server that accepts image URLs or local file paths and analyzes image content using the GPT-4o-mini model.

Japanese README

🚀 Quick Start

This is an MCP server that can receive either the URL of an image or the path of a local image file. It then uses the GPT-4o-mini model to analyze the content of the image.

✨ Features

• Accept image URLs or local file paths as input and provide detailed analysis of image content.
• Utilize the GPT-4o-mini model for high-precision image recognition and description.
• Check the validity of image URLs.
• Load images from local files and perform Base64 encoding.

📦 Installation

Install via Smithery

To automatically install the Image Analysis Server for Claude Desktop via Smithery:

npx -y @smithery/cli install @champierre/image-mcp-server --client claude

Manual Installation

# Clone the repository
git clone https://github.com/champierre/image-mcp-server.git # Or your forked repository
cd image-mcp-server

# Install dependencies
npm install

# Compile TypeScript
npm run build

Configuration

Using this server requires an OpenAI API key. Set the following environment variable:

OPENAI_API_KEY=your_openai_api_key

MCP Server Configuration

When using with tools like Cline, add the following configuration to the MCP server configuration file:

For Cline

Add the following to cline_mcp_settings.json:

{
  "mcpServers": {
    "@champierre/image-mcp-server": {
      "command": "node index.js"
    }
  }
}

For Claude Desktop App

Add the following to config.json (Claude's configuration file):

{
  "servers": {
    "@champierre/image-mcp-server": {
      "executablePath": "path/to/node",
      "commandLineArguments": ["index.js"]
    }
  }
}

💻 Usage Examples

After installation, you can start the server with the following command:

node index.js

Supported Interfaces

• GET /analyze: Analyze image content.
• POST /process-image: Process image files.

📚 Documentation

Important Note

⚠️ Important Note

You may encounter type errors during the build process. To resolve this issue, run the following command to install the dependencies:

npm install @types/mime-types
# Or
yarn add --dev @types/mime-types

Usage Tip

💡 Usage Tip

To run the server in development mode, execute the following command:

npm run dev

📄 License

This project is licensed under the MIT license.