Inspire MCP Server

A Model Context Protocol server that uses Inspire backend images search capabilities.

Available Tools

get-similar-images-by-description - Get similar images by their text description
- Required arguments:
  - description (string): Image description
  - limit (number): Pagination limit
  - offset (number): Pagination offset

Configuration

INSPIRE_API_BASE: base path for the backend gateway. Default: http://localhost:7080
IMAGES_BASE_PATH: base path for images. Example: https://<some-bucket>.s3.com/

Variables can be configured using environment variables or command-line arguments, depending on the runtime platform (Docker/Node).

Related MCP server: Parquet MCP Server

Building

Docker:

docker build -t tech-inspire/mcp .

Node:

npm ci && npm run build

Usage with Claude Desktop

Add this to claude_desktop_config.json

Docker

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

Node

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