semantic-image-search-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_imagesA | Search images using natural language queries with optional filters. This tool performs semantic search across your photo archive using AI-powered image understanding. It finds images based on their visual content, not just filenames or tags. Args: query: Natural language search query describing what you're looking for. Examples: "person in a room", "mountain landscape", "children playing", "sunset over water", "food on a table" limit: Maximum number of results to return (default: 10, max: 100) date_from: Filter results to images taken on or after this date (ISO format: YYYY-MM-DD) date_to: Filter results to images taken on or before this date (ISO format: YYYY-MM-DD) folder_pattern: Filter by folder path pattern (e.g., "2024" or "vacation") Returns: Dictionary containing: - success: Whether the search succeeded - query: The search query used - count: Number of results found - results: List of matching images with metadata and similarity scores |
| get_image_infoA | Get detailed metadata for a specific image. Retrieves comprehensive information about an image including EXIF data, camera settings, location, and file details. Args: image_id: Unique identifier for the image (obtained from search results) Returns: Dictionary containing: - success: Whether the operation succeeded - image: Complete metadata including: - filepath: Full path to the image file - filename: Name of the file - folder: Folder containing the image - width/height: Image dimensions - date_taken: When the photo was taken (if available) - camera_make/model: Camera information - lens_model: Lens used - focal_length: Focal length in mm - aperture: F-stop value - iso: ISO sensitivity - shutter_speed: Exposure time - gps_latitude/longitude: Location coordinates (if available) - tags: Associated tags |
| reindex_archiveA | Re-index the photo archive for new or modified images. Scans the archive for new or changed images and updates the search index. This should be run after adding new photos to the archive. Args: force: If True, re-index ALL images (slow). If False, only index new or modified images (default, recommended) Returns: Dictionary containing: - success: Whether indexing succeeded - total_images: Total number of images found - indexed: Number of images indexed - errors: Number of errors encountered - duration_seconds: Time taken to complete indexing |
| get_archive_statsA | Get statistics about the indexed photo archive. Provides an overview of your photo collection including total count, date range, storage size, and distribution by camera and folder. Returns: Dictionary containing: - success: Whether the operation succeeded - total_images: Total number of indexed images - date_range: Earliest and latest photo dates - total_size_bytes: Total storage used in bytes - total_size_gb: Total storage used in gigabytes - top_cameras: Most common camera models - top_folders: Folders with the most images |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct function: semantic search, metadata retrieval, index maintenance, and archive statistics. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern with lowercase and underscores: search_images, get_image_info, reindex_archive, get_archive_stats. The verbs are imperative and the nouns are clear.
Four tools is a well-scoped set for a semantic image search server, covering the essential operations without unnecessary bloat. It fits perfectly within the typical 3-15 tool range.
The tool set covers search, metadata retrieval, reindexing, and archive stats, which are the core workflows for this domain. A minor gap is the lack of direct image file access or delete/index management, but these are not critical for search functionality.