cyf1017/mcp-image-reader

★ 14PythonAudience · developerComplexity · 2/5Setup · moderate

Mindmap

mindmap
  root((mcp-image-reader))
    What it does
      Bridge to mimo API
      Describe local images
    Setup
      Two config files
      No extra dependencies
      Auto-loads with Claude
    How it works
      MCP protocol
      stdin stdout JSON
      Image encoding
    Use cases
      Claude Code image support
      Local file description

mindmap root((mcp-image-reader)) What it does Bridge to mimo API Describe local images Setup Two config files No extra dependencies Auto-loads with Claude How it works MCP protocol stdin stdout JSON Image encoding Use cases Claude Code image support Local file description

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Let Claude Code describe and reason about local image files on your computer during a conversation

USE CASE 2

Add image understanding to your Claude Code workflow using only Python's standard library

USE CASE 3

Connect Claude Code to the mimo-v2.5 vision API for image descriptions in an automated coding workflow

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a mimo-v2.5 API key and editing two Claude Code configuration files, no pip dependencies.

In plain English

This repository contains a small Python server that acts as a bridge between Claude Code and a third-party image-understanding API called mimo-v2.5. The purpose is to let Claude Code read and describe local image files on your computer, something it cannot do on its own without this kind of connector. The way it works: when you ask Claude to look at an image, Claude calls a tool named describe_image that this server provides. The server reads the image file from your disk, encodes it, sends it to the mimo-v2.5 API, and returns a text description back to Claude. Claude then uses that description to continue the conversation. The API endpoint and authentication key are set in a configuration file, and the server runs in the background whenever Claude Code is open. Setup involves creating one Python file (about 250 lines) in a specific folder under your home directory, then editing two Claude configuration files to register the server. The README documents each file and each field in detail, with notes about Windows path formatting. After restarting Claude Code, the server loads automatically. To remove it, you delete the configuration entries from those two files and remove the folder. The README notes that uninstalling leaves no background processes or other residue. The README is written in Chinese and includes a troubleshooting table covering common errors such as a missing API key, a wrong file path, Python not being found, and a Windows character encoding issue that the server code already handles. It also includes brief notes on how the MCP protocol works: messages travel over standard input and output as JSON, and the server responds to a small set of method names for initialization, listing tools, and running tool calls. The server uses only Python's standard library with no external dependencies beyond the API calls it makes.

Copy-paste prompts

Prompt 1

I want Claude Code to be able to read and describe images on my computer. Walk me through setting up mcp-image-reader step by step.

Prompt 2

How do I configure the mimo-v2.5 API endpoint and authentication key for the mcp-image-reader server?

Prompt 3

After setting up mcp-image-reader, how do I ask Claude Code to describe a PNG file at a specific local path?

Prompt 4

How do I cleanly uninstall mcp-image-reader and confirm no background processes are left running?

Open on GitHub → Explain another repo

← cyf1017 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.