Galaxy MCP

🚀 Galaxy MCP Server

This project offers a Model Context Protocol (MCP) server for interacting with the Galaxy bioinformatics platform. It allows AI assistants and other clients to connect to Galaxy instances, search and execute tools, manage workflows, and access other features of the Galaxy ecosystem.

🚀 Quick Start

The galaxy-mcp CLI comes with both stdio (local) and HTTP transports. Select the setup that suits your client:

# Stdio transport (default) – ideal for local development tools
uvx galaxy-mcp

# HTTP transport with OAuth (for remote/browser clients)
export GALAXY_URL="https://usegalaxy.org.au/"          # Target Galaxy instance
export GALAXY_MCP_PUBLIC_URL="https://mcp.example.com" # Public base URL for OAuth redirects
export GALAXY_MCP_SESSION_SECRET="$(openssl rand -hex 32)"
uvx galaxy-mcp --transport streamable-http --host 0.0.0.0 --port 8000

When running over stdio, you can supply long - lived credentials via environment variables:

export GALAXY_URL="https://usegalaxy.org/"
export GALAXY_API_KEY="your-api-key"

For OAuth flows, the server exchanges user credentials for short - lived Galaxy API keys on demand, so you usually leave GALAXY_API_KEY unset.

Alternative Installation

# Install from PyPI
pip install galaxy-mcp

# Run (stdio by default)
galaxy-mcp

# Or from source using uv
cd mcp-server-galaxy-py
uv sync
uv run galaxy-mcp --transport streamable-http --host 0.0.0.0 --port 8000

✨ Features

• Galaxy Connection: Connect to any Galaxy instance using a URL and API key.
• OAuth Login (optional): Provide browser - based sign - in that exchanges credentials for temporary Galaxy API keys.
• Server Information: Retrieve comprehensive server details including version, configuration, and capabilities.
• Tools Management: Search, view details, and execute Galaxy tools.
• Workflow Integration: Access and import workflows from the Interactive Workflow Composer (IWC).
• History Operations: Manage Galaxy histories and datasets.
• File Management: Upload files to Galaxy from local storage.
• Comprehensive Testing: A full test suite with mock - based testing for reliability.

📦 Installation

Container Usage

The published image defaults to stdio transport (no HTTP listener):

docker run --rm -it \
  -e GALAXY_URL="https://usegalaxy.org/" \
  -e GALAXY_API_KEY="your-api-key" \
  galaxyproject/galaxy-mcp

For OAuth + HTTP:

docker run --rm -it -p 8000:8000 \
  -e GALAXY_URL="https://usegalaxy.org.au/" \
  -e GALAXY_MCP_TRANSPORT="streamable-http" \
  -e GALAXY_MCP_PUBLIC_URL="https://mcp.example.com" \
  -e GALAXY_MCP_SESSION_SECRET="$(openssl rand -hex 32)" \
  galaxyproject/galaxy-mcp

💻 Usage Examples

Connect to Claude Desktop

• Make sure that GalaxyMCP runs with uvx galaxy-mcp.
• Add export GALAXY_SERVER=https://usegalaxy.org to your .bashrc (or equivalent).
• Download and install claude desktop.
• Go to Settings -> Developer -> Edit Config.
• Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "galaxy-mcp": {
      "command": "uvx",
      "args": ["galaxy-mcp"],
      "env": {
        "GALAXY_URL": "https://usegalaxy.org",
        "GALAXY_API_KEY": "SECRETS"
      }
    }
  }
}

• Under the developer menu, you should now see galaxy-mcp as running (you may need to restart Claude desktop).
• Prompt Claude with "can you connect to galaxy".
• If you have not provided the optional env config, you'll be asked for connection details, which you can provide like "Use my Galaxy API key: XXXXXXX".
• Talk to Claude to work with your galaxy instance, e.g., "give a summary with my histories".

📚 Documentation

See the Python implementation README for specific instructions and documentation.

📄 License

MIT