Inspire

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

typescript

3

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tech-inspire-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "INSPIRE_API_BASE=<API_URL>",
        "-e",
        "IMAGES_BASE_PATH=<IMAGE_BASE_PATH>",
        "tech-inspire/mcp"
      ],
      "env": {
        "IMAGES_BASE_PATH": "<IMAGE_BASE_PATH>",
        "INSPIRE_API_BASE": "<API_URL>"
      }
    }
  }
}

Inspire MCP Server connects the Inspire backend image search capabilities to a Model Context Protocol client, enabling you to find similar images by description and integrate image search into your workflows. This guide shows practical, end-to-end steps to run the MCP server locally, how to use it with an MCP client, and how to configure essential environment variables.

How to use

You run the Inspire MCP Server as a local MCP endpoint and connect your MCP client to it. The server exposes the get-similar-images-by-description function, which lets you retrieve images similar to a text description. When you start the server, you provide the base API URL for the backend gateway and the base path for images. Once running, point your MCP client at the local instance and supply image descriptions to find matches.

How to install

Prerequisites you need before starting: Node.js, npm, Docker, and an internet connection to pull images and install dependencies.

# Docker (recommended if you want to run via containers)
docker build -t tech-inspire/mcp .

# If you prefer a Node-based run (build step included if applicable)
npm ci && npm run build

Additional notes

To run via Docker you can start the MCP server with the following configuration snippet. This passes the required environment variables INSPIRE_API_BASE and IMAGES_BASE_PATH and runs the Inspire MCP image locally.

{
  "mcpServers": {
    "inspire_docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "INSPIRE_API_BASE=<API_URL>",
        "-e",
        "IMAGES_BASE_PATH=<IMAGE_BASE_PATH>",
        "tech-inspire/mcp"
      ]
    }
  }
}

To run via Node (local process) you can start the MCP server with the following configuration snippet. This runs the built index script and passes the environment variable overrides.

{
  "mcpServers": {
    "inspire_node": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js",
        "--INSPIRE_API_BASE=<INSPIRE_API_BASE>",
        "--IMAGES_BASE_PATH=<IMAGES_BASE_PATH>"
      ]
    }
  }
}

Available tools

get-similar-images-by-description

Fetches images that match a given text description with pagination support via limit and offset.