JUHE API Marketplace
tech-inspire avatar
MCP Server

Inspire MCP Server

A Model Context Protocol server that enables searching for similar images by text description, integrating Inspire's backend image search capabilities with LLM interfaces like Claude Desktop.

3
GitHub Stars
8/23/2025
Last Updated
MCP Server Configuration
1{
2 "name": "inspire",
3 "command": "docker",
4 "args": [
5 "run",
6 "--rm",
7 "-i",
8 "-e",
9 "INSPIRE_API_BASE=",
10 "-e",
11 "IMAGES_BASE_PATH=",
12 "tech-inspire/mcp"
13 ]
14}
JSON14 lines

README Documentation

Inspire MCP Server

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

Inspire Server MCP server

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.

Quick Install

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source