🚧 Under Development

This project is still in an alpha stage. Implementation is not complete. Expect rapid changes and incomplete features.

<img src="img/flowreglogo.png" alt="FlowReg logo" height="64"> Flow-Registration MCP

Model Context Protocol (MCP) server for Flow-Registration - variational optical-flow motion correction for 2-photon (2P) microscopy videos and volumetric 3D scans.

This MCP server provides programmatic access to Flow-Registration functionality through the Model Context Protocol, enabling AI assistants and other MCP clients to perform motion correction on microscopy data.

Related projects

• Original Flow-Registration repo: https://github.com/FlowRegSuite/flow_registration
• Python implementation: https://github.com/FlowRegSuite/pyflowreg
• ImageJ/Fiji plugin: https://github.com/FlowRegSuite/flow_registration_IJ
• Napari plugin: https://github.com/FlowRegSuite/napari-flowreg

Requirements

• Python 3.10 or higher
• FastMCP framework

Installation

Clone the repository and install dependencies:

git clone https://github.com/FlowRegSuite/flowreg-mcp.git
cd flowreg-mcp
pip install -r requirements.txt

Setup as MCP Server

To use this as an MCP server with Claude Desktop or other MCP clients:

1. Install the MCP server:

pip install -e .

2. Configure your MCP client (e.g., Claude Desktop) to connect to the server:

{
  "mcpServers": {
    "flowreg": {
      "command": "python",
      "args": ["-m", "flowreg_mcp"],
      "cwd": "/path/to/flowreg-mcp"
    }
  }
}

Getting started

Once configured, the MCP server exposes Flow-Registration functionality through standard MCP tools and resources. The server provides motion correction capabilities for microscopy data through a programmatic interface.

Dataset

The dataset which we used for our evaluations is available as 2-Photon Movies with Motion Artifacts.

Citation

Details on the original method and video results can be found here.

If you use parts of this code or the plugin for your work, please cite

“Pyflowreg,” (in preparation), 2025.

and for Flow-Registration

P. Flotho, S. Nomura, B. Kuhn and D. J. Strauss, “Software for Non-Parametric Image Registration of 2-Photon Imaging Data,” J Biophotonics, 2022. doi:https://doi.org/10.1002/jbio.202100330

BibTeX entry

@article{flotea2022a,
    author = {Flotho, P. and Nomura, S. and Kuhn, B. and Strauss, D. J.},
    title = {Software for Non-Parametric Image Registration of 2-Photon Imaging Data},
    year = {2022},
  journal = {J Biophotonics},
  doi = {https://doi.org/10.1002/jbio.202100330}
}