mcp server

mcp-server

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

tech-inspire/mcp-servercommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tech-inspire-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@tech-inspire/mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 26, 2026

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.