mcp

This MCP server exposes an Inspire-backed MCP endpoint that lets you find similar images based on a text description. The primary tool available is get-similar-images-by-description, which requires three inputs: a textual description of the image, a limit for pagination, and an offset for pagination. The server reads two environment variables to function: INSPIRE_API_BASE, which should point to the Inspire backend gateway, and IMAGES_BASE_PATH, which is the base URL where images are hosted. You can run the server via Docker (using the tech-inspire/mcp image) or locally with a built Node distribution if you have a prebuilt index.js. Once running, you can query for similar images by passing a description and adjusting limit/offset to page through results.

Prerequisites:

• Docker installed and running
• Optional: Node.js and npm if you prefer building/running via Node

Installation steps (Docker):

1. Pull and run the MCP image: docker pull tech-inspire/mcp docker run --rm -i
   -e INSPIRE_API_BASE=http://localhost:7080
   -e IMAGES_BASE_PATH=https://<your-bucket>.s3.com/
   tech-inspire/mcp

Configuration:

• Set INSPIRE_API_BASE to your Inspire backend gateway URL (default http://localhost:7080)
• Set IMAGES_BASE_PATH to your images base URL if needed

If building from Node (prebuilt index):

1. Install dependencies and build: npm ci npm run build
2. Run the server (example): node /path/to/repo/build/index.js --INSPIRE_API_BASE=http://localhost:7080 --IMAGES_BASE_PATH=https://<your-bucket>.s3.com/

Environment variables can be adjusted in the commands above.

Notes:

• The primary tool is get-similar-images-by-description with required args: description (string), limit (number), offset (number).
• If using Docker, ensure INSPIRE_API_BASE and IMAGES_BASE_PATH are provided as environment variables at runtime.
• The default INSPIRE_API_BASE is http://localhost:7080 if not overridden.
• For Node deployments, ensure the built index.js path matches your project structure.
• When using Claude Desktop, you can embed the server in config.json using either the Docker or Node examples shown in the README.