MCP Server

🚀 Inspire MCP Server

A Model Context Protocol server leveraging the backend image search capabilities of Inspire.

🚀 Quick Start

This server provides a convenient way to search for similar images using text descriptions. Below are the available tools and how to configure, build, and use the server.

✨ Features

Available Tools

• get-similar-images-by-description: Retrieve similar images based on their text descriptions.
  • Required arguments:
    • description (string): The description of the image.
    • limit (number): The pagination limit.
    • offset (number): The pagination offset.

📦 Installation

Configuration

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

You can configure these variables using environment variables or command - line arguments, depending on your runtime platform (Docker/Node).

Building

Docker

docker build -t tech-inspire/mcp .

Node

npm ci && npm run build

💻 Usage Examples

Usage with Claude Desktop

Add the following configuration 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 detailed in the LICENSE file.