Skip to content

tools/mcp-swap is Java and outside SCRIPTS.md #174

Closed

Description

@tony

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.md keeps a script for "a CI job, a release step, a code generator, a documentation check, or a maintainer task named in CONTRIBUTING.md".
  • SCRIPTS.md says "Scripts are Python", with inline PEP 723 dependencies run through uv run.

mcp-swap meets neither:

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.md already documents registering the server with claude mcp add, codex mcp add and 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 the ruff, ty and pytest checks the policy requires.
  • If the policy should allow a Java tool because it exercises the library's own MCP server, amend SCRIPTS.md to say so, and add the CONTRIBUTING task.

References

Activity

  1. added 2 commits that reference this issue on Nov 15, 2026
    c350771
    d66b6f2
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions