Metashape

Clone the metashape-mcp repository to your local machine. All dependencies auto-install on first run inside Metashape.

git clone https://github.com/jenkinsm13/metashape-mcp.git
cd metashape-mcp

The proxy component that bridges your MCP client to the Metashape server requires FastMCP 2.0+. Install it in the Python that Claude Code or Claude Desktop will use.

pip install "fastmcp>=2.0.0"

There are three ways to start the server. The easiest is to copy start_mcp_server.py to Metashape's auto-run scripts folder so it launches automatically with Metashape.

# macOS auto-start path:
# ~/Library/Application Support/Agisoft/Metashape Pro/scripts/

# Windows auto-start path:
# C:\Users\<user>\AppData\Local\Agisoft\Metashape Pro\scripts\

# Or run manually via Tools > Run Script, selecting:
# scripts/start_mcp_server.py

By default the server listens on TCP port 8765. Override this with the METASHAPE_MCP_PORT environment variable before launching Metashape.

export METASHAPE_MCP_PORT=8765

Add the metashape server to your .mcp.json (Claude Code project config), pointing to the proxy module and setting PYTHONPATH to the src directory.

{
  "mcpServers": {
    "metashape": {
      "command": "python",
      "args": ["-m", "metashape_mcp.proxy"],
      "env": {
        "PYTHONPATH": "/path/to/metashape-mcp/src"
      }
    }
  }
}

Claude Desktop can connect directly to the Metashape HTTP endpoint without the proxy. Ensure Metashape is running with the server active.

{
  "mcpServers": {
    "metashape": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}