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

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>"
      ]
    }
  }
}

License

This MCP server is licensed under the GNU General Public License, as described in the LICENSE file.