Inspire MCP Server

Name: Inspire MCP Server
Author: tech-inspire

@tech-inspire

Repository

About Inspire MCP Server

Model Context Protocol server for images search using Inspire backend. Claude Dekstop ready

#nodejs #mcp #image-search #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-tech-inspire": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "tech-inspire/mcp",
        "."
      ]
    }
  }
}

Tools

Get similar images by their text description

Overview

What is Inspire MCP Server?

A Model Context Protocol (MCP) server that uses the Inspire backend to search for images based on text descriptions. It is designed for developers and AI agents that need to retrieve visually similar images programmatically.

How to use Inspire MCP Server?

Configure by setting the INSPIRE_API_BASE (default http://localhost:7080) and IMAGES_BASE_PATH environment variables, or pass them as command‑line arguments. Then run the server with Docker or Node (after building with npm ci && npm run build). Add it to your MCP client (e.g., Claude Desktop) by including the appropriate entry in claude_desktop_config.json.

Key features of Inspire MCP Server

Uses the Inspire backend for image search.
Provides a single tool: get-similar-images-by-description.
Accepts text descriptions with pagination (limit, offset).
Deployable via Docker or Node.
Configurable through environment variables or CLI arguments.

Use cases of Inspire MCP Server

Searching for images that match a natural language description.
Integrating visual search capabilities into AI assistants like Claude Desktop.
Automating image retrieval in workflows that require text-to-image matching.

FAQ from Inspire MCP Server

What tool does Inspire MCP Server expose?

It exposes one tool: get-similar-images-by-description. This tool takes a text description, a limit, and an offset (all required) and returns similar images.

How do I configure the server?

Set the INSPIRE_API_BASE (backend gateway URL) and IMAGES_BASE_PATH (base URL for image files) either as environment variables or as command‑line arguments (e.g., --INSPIRE_API_BASE=<URL>).

Can I run it without Docker?

Yes. Build with npm ci && npm run build, then run node build/index.js with the required arguments.

How do I use it with Claude Desktop?

Add an entry to claude_desktop_config.json. For Docker, use the docker run command with environment variables. For Node, use node build/index.js with --INSPIRE_API_BASE and --IMAGES_BASE_PATH.