Repository navigation
tools/mcp-swap is Java and outside SCRIPTS.md #174
Description
Summary
tools/mcp-swap is a Gradle application of about 4,300 lines of Java and 2,000 lines of tests that rewrites the MCP configuration of eight agent CLIs so they point at a local libtmux-mcp build. .github/SCRIPTS.md says scripts are Python and stay only for a current use named in CONTRIBUTING. mcp-swap is Java, no CONTRIBUTING task names it, and the cleanup issue #170 does not list it.
Motivation
The policy sets two conditions for a support script:
SCRIPTS.mdkeeps a script for "a CI job, a release step, a code generator, a documentation check, or a maintainer task named in CONTRIBUTING.md".SCRIPTS.mdsays "Scripts are Python", with inline PEP 723 dependencies run throughuv run.
mcp-swap meets neither:
- It is a Gradle subproject with its own TOML editor (
TomlEditor), a JSONC editor (JsoncEditor), a transaction guard, a lock and a recovery record. The only line in.github/CONTRIBUTING.mdthat mentions it says itsruntask is not quarantined. Nothing describes when a maintainer runs it. The only listing is a row intools/README.md. - Clean up support scripts under SCRIPTS.md #170 sorts the shell and Python files under
tools/,.github/scripts/andgradle/into delete, move, consolidate and keep.mcp-swapis in none of those lists, so finishing Clean up support scripts under SCRIPTS.md #170 leaves it as it is.
It also carries upkeep. The newest commit touching it, 4b7758c, fixes the TOML editor for inline mcp_servers tables, and the tomlj 2.2.0 bump could not land without it. Fifteen commits touch the directory, the first on 2026-09-06 when it replaced a Python switcher.
Proposal
Decide one of these and record it in #170:
- Delete it.
libtmux-mcp/README.mdalready documents registering the server withclaude mcp add,codex mcp addand a Claude Desktop JSON entry. - Name it as a maintainer task in CONTRIBUTING, with the reason a maintainer runs it, and move it to Python under
scripts/mcp-swap/with a README, tests and theruff,tyandpytestchecks the policy requires. - If the policy should allow a Java tool because it exercises the library's own MCP server, amend
SCRIPTS.mdto say so, and add the CONTRIBUTING task.
References
- Clean up support scripts under SCRIPTS.md #170, the
SCRIPTS.mdcleanup. tools/mcp-swap/README.mddescribes the eight clients it edits.
Activity
docs(scripts[mcp-swap]) Keep tools/mcp-swap as Java and name its task
docs(scripts[mcp-swap]) Keep tools/mcp-swap as Java and name its task