mcpField
I
Inspire MCP Server

Inspire MCP Server

Local
github.com/tech-inspireSearch3Updated 68w ago
Repository

About Inspire MCP Server

Inspire MCP Server is an image-search MCP server built on the Inspire backend. MCP clients can find similar images from text descriptions and set pagination parameters.

Key features

  1. 01Search similar images by description
  2. 02Set result limit and offset
  3. 03Configure backend and image paths

Use cases

  1. 01Find images from text descriptions
  2. 02Browse similar-image results by page

MCP support

The MCP server exposes a tool for searching similar images from descriptions to MCP clients.

#nodejs#mcp#image-search#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tech-inspire": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

README image README image

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.