galaxy-tool-refactor-mcp 0.2.0

MCP server exposing the Galaxy tool refactoring facade to AI agents.

galaxy-tool-refactor-mcp

An MCP server that exposes the Galaxy tool refactoring framework to AI coding agents. A tier-4 sibling of galaxy-tool-refactor-cli: both wrap the galaxy-tool-refactor-registry facade (tier 3.6) for a different audience — the CLI for humans at a terminal, this for agents over the Model Context Protocol.

Shape

The facade is library-first (structured args in, structured results out, no disk writes unless asked, introspectable), so the server is a thin adapter:

• service.py — protocol-agnostic. Pure functions that take XML as a str (plus rulesets / select / ignore) and return JSON-able dicts by calling the facade. No mcp import; fully unit-tested.
• server.py — the FastMCP binding. A small handler per tool delegates to service, and is the error boundary (facade UnknownRuleset / UnknownRuleCode and tier-1 ToolXmlSyntaxError → a clean MCP tool error).

Tools

MCP tool	What it does
format_tool	Apply a ruleset's fixable rules then format; returns canonical XML + advisory notes.
upgrade_tool	Profile-upgrade then format; returns upgraded XML, steps applied, the behavior-preserving verdict, and notes.
check_tool	Report-only detect over the selected rules; returns the findings (each flagged fixable vs advisory).
list_rulesets	The baked-in rulesets (name / codes / is_default / description).
list_rules	The baked-in rules (code / summary / family / fixable / rulesets).

Agents supply content and receive content — the server never writes to disk.

Run

uv run galaxy-tool-refactor-mcp   # serves over stdio

Point an MCP client (e.g. a coding agent) at that command. list_rulesets / list_rules let the agent discover the available rulesets and rule codes at runtime instead of hardcoding them.

See docs/decisions.md D1 for the design, and docs/vision.md for the longer-horizon agent-authored-rules direction (Goal 2, still future).