Fiji MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FIJI_PATH | Yes | Path to the Fiji installation folder (the one containing jars/ and plugins/) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_all_commandsA | Enumerate Fiji/ImageJ commands from SciJava CommandService and legacy ij.Menus. Large installs return thousands of entries; lower limit for faster responses. |
| search_commandsA | Search installed commands by substring on name/class, plus fuzzy title matching. Use before describe_plugin to find the exact menu label. |
| describe_pluginA | Resolve one command by name and return SciJava input metadata when available. Legacy ImageJ1-only plugins may omit inputs; use run_macro in that case. |
| list_extensionsA | List configured ImageJ update sites (name and URL) when the updater classes are present. May return an empty list on minimal installs; see note field. |
| list_open_imagesA | List open image windows with id, title, dimensions, and ImageJ type constant. |
| get_image_infoA | Read dimensions, channel/frame/slice counts, bit depth, and ROI statistics for one image. Uses the front image when image_title is omitted. |
| health_checkA | Return runtime health: Fiji path, headless/GUI mode, ImageJ version, and configured operation timeout. Use before long jobs to confirm the bridge is alive. |
| run_macroA | Execute ImageJ1 macro text in the current Fiji session. Returns macro return value and a tail of the ImageJ log. Prefer small, focused macros; increase timeout for heavy I/O. |
| open_imageA | Open an image from disk in Fiji and show it as the active window. Verify the path exists on the MCP host before calling. |
| save_imageA | Save the currently active image to disk using ImageJ's saveAs. Requires an image window to be frontmost in Fiji. |
| run_batch_macrosA | Run several macros in sequence. On failure, behavior depends on continue_on_error: either stop or record the error and continue. Each successful step returns the same shape as run_macro. |
| screenshot_fijiA | Capture pixels for verification: full_screen (primary monitor via Robot), active_image (current ImagePlus), or results_table (render Measure/Results data). Use active_image or results_table when running headless without a display. |
| parse_macro_outputA | Turn macro return text or a pasted Results snippet into structured JSON: detected format, key/value map, tabular rows, and/or extracted numbers. Prefer macros that |
| compare_screenshotsA | Compare two screenshot_fiji payloads (before/after). Returns mean absolute error and RMSE on aligned grayscale patches plus a side-by-side JPEG for quick visual diff. |
| list_macro_templatesA | List bundled macro snippets (filters, segmentation, Z-project, channels, optional Fiji plugins) with stable ids. Filter by category: filters, process, segment, analyze, image, annotate, channels, stack, plugins. |
| get_macro_templateA | Fetch one bundled macro template by id (from list_macro_templates). |
| get_session_traceA | Return recent tool invocations (run_macro, open_image, …) in order plus optional live open-image list. Trace is in-process only (resets when the MCP server restarts). |
| clear_session_traceA | Clear the in-process session trace (does not close Fiji images). |
| run_workflowA | Run a scripted pipeline: each step runs a macro, optionally followed by a screenshot. Supports MCP progress when the client requests it. Use verify_each_step=false for faster runs. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/surajinacademia/Fiji_imageJ_mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server