{"id":"2be9abb8-cfbd-40ce-9191-54d7fca69904","slug":"image-reader-mcp","kind":"mcp","name":"image-reader-mcp","summary":"An MCP (Model Context Protocol) server (using FastMCP) to provide tools for listing local image files and reading their content. Designed for LLM agent integration.","owner":"moiri-gamboni","repoUrl":"https://github.com/moiri-gamboni/image-reader-mcp","license":"GPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":12,"match":null,"fewStars":false,"format":"mcp","createdAt":null,"addedAt":"2026-10-14T05:07:01.293Z","logoUrl":"https://avatars.githubusercontent.com/u/3668735?u=c2097003ce964a7f8fa50dfaf1f036ec2d111d0f&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","design-media","files-documents"],"tags":["cursor","fastmcp","llm"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T10:15:00.431Z","sample":false,"url":"https://conduits.dev/tools/image-reader-mcp","language":"TypeScript","transports":["stdio"],"install":{"npm":"image-reader-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Image Reader MCP Server\n\nA simple MCP server built with FastMCP that provides tools to:\n\n- List image files in a specified directory.\n- Read a specific image file and return its content.\n\n\n## Tools\n\nThis server provides the following tools:\n\n### `list_images`\n\n*   **Description:** List image files in a specified directory.\n*   **Parameters:**\n    *   `directoryPath` (string): The absolute path to the directory to scan for images.\n*   **Returns:** A list of image filenames found in the directory or a message indicating no images were found.\n*   **Supported Extensions:** `.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.webp`, `.svg`\n\n### `read_image`\n\n*   **Description:** Reads a specific image file and returns its content as base64.\n*   **Parameters:**\n    *   `filePath` (string): The absolute path to the image file to read.\n*   **Returns:** An object containing the image content suitable for display (using `imageContent` helper from `fastmcp`).\n*   **Supported Extensions:** `.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.webp`, `.svg`\n\n### Setup\n\nTo configure an MCP client, add the `imageReader` entry to the `mcpServers` object. It should look something like this:\n\n```json\n{\n  \"mcpServers\": {\n    // ... other servers might be here ...\n    \"imageReader\": {\n      \"command\": \"npx\",\n      \"args\": [\"image-reader-mcp\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n**Important Note:** When using this server with Cursor, it currently seems to function only when Claude Sonnet is selected (other models don't seem to have vision enabled).\n"}