Skip to content
image-resolver-mcp
aiEpic1000 XP

image-resolver-mcp

An MCP server that stops AI from dropping emojis into your UI. It gives any AI assistant (Cursor, Claude Desktop, VS Code) royalty free image search from Pexels and Unsplash through natural language. Published on npm, installable with a single npx command.

Role
Creator and maintainer (full-stack: MCP server, provider integrations, npm release)
Built in
Personal project
Team
Solo
Stack
6 techs

image-resolver-mcp is a Model Context Protocol (MCP) server that gives any AI coding assistant real image search instead of emoji placeholders. When an assistant like Cursor, Claude Desktop, or VS Code needs an image for a UI, it can ask in natural language and get back royalty free photos from Pexels and Unsplash.

The server is published on npm and installs with a single npx command, so it plugs into any MCP compatible client with almost no setup. It exposes image search as a tool the assistant can call, handling provider APIs, query resolution, and result formatting behind a clean MCP interface.

Built in TypeScript on Node.js, it follows the MCP specification for tools and transport, making it a small, focused, composable piece of AI tooling rather than a monolith.

What was hard → How I solved it

The problem

Giving AI assistants a reliable way to fetch real images instead of emoji placeholders

The fix

Implemented an MCP server exposing image search as a callable tool over the standard protocol

The problem

Wrapping two different image provider APIs (Pexels and Unsplash) behind one natural language interface

The fix

Normalized Pexels and Unsplash responses into a single consistent result shape

The problem

Packaging the server so it installs into any MCP client with a single command

The fix

Published to npm with an npx friendly entry point so setup is one command

What it changed

Installable from npm with a single npx command

Works across MCP clients including Cursor, Claude Desktop, and VS Code

Replaces emoji placeholders with royalty free photography in AI assisted UI work

Built with

Frontend
TypeScript
Backend
Node.js
Other
MCPnpmPexels APIUnsplash API