analyze_imageLABSCO SUMMARY
Gives a text-only client eyes, for the price of one OpenAI key.
Two tools, one for a URL and one for a path, is the whole surface — which is right when the job is simply "what is in this picture". The detail that causes most failures is path translation: the server resolves the path in its own environment and does not rewrite it, so a Windows path handed to a WSL server will not resolve.
What it is
A small TypeScript server that sends an image to the GPT-4o-mini model and returns an analysis of what is in it. It accepts either a URL, which it validates first, or a local file, which it reads and Base64-encodes before sending.
What you get
analyze_imagetakes an image URL and describes its contentanalyze_image_from_pathdoes the same for a local file- URL validity is checked before the call, so a broken link fails early rather than as a model error
Requirements
An OpenAI API key in OPENAI_API_KEY. Install via Smithery, or clone and run npm install then npm run build and point your client at dist/index.js with node. Paths are interpreted in the environment where the server runs — if the server is under WSL and your client has a Windows path, the client must convert it before calling. A TS7016 type error about mime-types during the build does not affect execution.
Setup effort
One command plus a key — npx -y @smithery/cli install @champierre/image-mcp-server --client claude, then supply credentials
USE CASES
01
Describing an image in a text-only assistant
Pass the URL and get a description you can act on.
02
Reading a screenshot you just took
Point at the local file and ask what it shows.
03
Checking an image link before using it
The URL is validated first, so a dead link is reported rather than silently failing downstream.
2 tools
Listed in project docs. Your client may show a different list.
analyze_image_from_pathBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- npx on PATH
- OPENAI_API_KEY in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @smithery/cli install @champierre/image-mcp-server --client claudeMCP Clients
Cline, Claude Desktop
JSON
{
"mcpServers": {
"image-analysis": {
"command": "node",
"args": [
"<YOUR_PATH_TO_IMAGE_MCP_SERVER>/dist/index.js"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}
