image-mcp-server

@champierre

关于 image-mcp-server

暂无概览

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "image-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@champierre/image-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is image-mcp-server?

An MCP server that receives image URLs or local file paths and analyzes image content using the GPT-4o-mini model. It is designed for AI assistants that need automated image description and recognition.

How to use image-mcp-server?

Install manually by cloning the repository, running npm install and npm run build, or automatically via Smithery with npx -y @smithery/cli install @champierre/image-mcp-server --client claude. Set the OPENAI_API_KEY environment variable. Then add the server configuration (with node and the path to dist/index.js) to your MCP client settings (e.g., cline_mcp_settings.json or claude_desktop_config.json). Two tools become available: analyze_image (for URLs) and analyze_image_from_path (for local file paths).

Key features of image-mcp-server

Accepts image URLs or local file paths as input
Provides detailed image analysis using GPT-4o-mini
Checks validity of image URLs before analysis
Loads images from local files and encodes them as Base64

Use cases of image-mcp-server

An AI assistant analyzing an image from a web URL
An AI assistant describing an image stored on the local filesystem
Automating image content verification for workflows

FAQ from image-mcp-server

What tools does image-mcp-server provide?

analyze_image for analyzing images from a URL, and analyze_image_from_path for analyzing images from a local file path.

How should local file paths be specified when the server runs on WSL or Windows?

If the server runs on WSL, a Windows path (e.g., C:\...) must be converted to a WSL path (e.g., /mnt/c/...) before passing it to the tool. If the server runs on Windows, a WSL path must be converted to a UNC path (e.g., \\wsl$\Distro\...). Path conversion is the responsibility of the AI assistant.

What API key is required?

An OpenAI API key set as the environment variable OPENAI_API_KEY.

I see a TypeScript type error (TS7016) when building. Does it affect execution?

No, the JavaScript compilation succeeds and the server runs correctly. To silence the error, install @types/mime-types as a development dependency.

Where can I install image-mcp-server automatically?

Via Smithery using the command npx -y @smithery/cli install @champierre/image-mcp-server --client claude.

常见问题

What tools does image-mcp-server provide?

`analyze_image` for analyzing images from a URL, and `analyze_image_from_path` for analyzing images from a local file path.

How should local file paths be specified when the server runs on WSL or Windows?

If the server runs on WSL, a Windows path (e.g., `C:\...`) must be converted to a WSL path (e.g., `/mnt/c/...`) before passing it to the tool. If the server runs on Windows, a WSL path must be converted to a UNC path (e.g., `\\wsl$\Distro\...`). Path conversion is the responsibility of the AI assistant.