MCP.so
Sign In

Inspire MCP Server

@tech-inspire

Basic information

Category

Other

License

GPL-3.0

Transports

stdio

Author

tech-inspire

About Inspire MCP Server

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

Inspire MCP Server 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",
        "."
      ]
    }
  }
}

Inspire MCP Server tools

1

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.

Frequently asked questions

1

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.

2

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>`).

3

Can I run it without Docker?

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

4

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`.

5

What license does Inspire MCP Server use?

It is licensed under the GNU General Public License.

Comments

More Other MCP servers