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.
Available Tools
get-similar-images-by-description
- Get similar images by their text description- Required arguments:
description
(string): Image descriptionlimit
(number): Pagination limitoffset
(number): Pagination offset
- Required arguments:
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