Skip to main content
Glama
Image Analysis MCP Server

Image Analysis MCP Server

by champierre

image-mcp-server

This is an MCP server that receives an image URL and analyzes the image content using the GPT-4o-mini model.

function

  • Takes an image URL as input and performs detailed analysis of the image's content

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

  • Image URL validity check function

Related MCP server: Letz AI MCP

install

# リポジトリをクローン
git clone https://github.com/champierre/image-mcp-server.git
cd image-mcp-server

# 依存パッケージのインストール
npm install

# TypeScriptのコンパイル
npm run build

setting

To use this server, you will need an OpenAI API key, so set the following environment variables:

OPENAI_API_KEY=your_openai_api_key

Configuring the MCP Server

To use it with tools like Cline, add the following to your MCP server configuration file:

For VSCode Claude extension

Add the following to cline_mcp_settings.json :

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop App

Add the following to claude_desktop_config.json :

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

How to use

Once an MCP server is configured, the following tools are available:

  • analyze_image : Takes an image URL and analyzes its content

Usage Example

画像URLを分析してください: https://example.com/image.jpg

development

# 開発モードで実行
npm run dev

license

ISC

Available Tools

2 tools
analyze_imageC

Receives an image URL and analyzes the image content using GPT-4o-mini

Inputs: imageUrl (required).

analyze_image_from_pathA

Loads an image from a local file path and analyzes its content using GPT-4o-mini. AI assistants need to provide a valid path for the server execution environment (e.g., Linux path if the server is running on WSL).

Inputs: imagePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 2 tools

    Disambiguation1/5

    The two tools are nearly identical in purpose—both analyze image content using GPT-4o-mini—differing only in input source (URL vs. local path). This creates high ambiguity, as an agent might easily misselect between them based on minor context cues, and they essentially duplicate functionality with no distinct operational domains.

    Naming Consistency5/5

    Tool names follow a perfectly consistent verb_noun pattern with clear, descriptive suffixes ('analyze_image' and 'analyze_image_from_path'). Both use snake_case and maintain a uniform naming style, making them predictable and easy to interpret within the set.

    Tool Count2/5

    With only 2 tools, the server feels under-scoped for an 'Image Analysis' domain, as it lacks basic operations like object detection, text extraction, or image comparison. The count is too low to support comprehensive analysis workflows, limiting agent capabilities to a single, narrowly defined task.

    Completeness2/5

    The toolset is severely incomplete for image analysis, missing essential functions such as image preprocessing, metadata extraction, or batch processing. It offers only one core action (analysis) in two input variants, leaving obvious gaps that will hinder agents from performing varied or advanced tasks in this domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers