mcp-tidy

mcp-tidy is a command-line tool for discovering, evaluating, and cleaning up MCP (Minecraft Comparable Protocol) servers configured in Claude Code. It helps you see all configured MCP servers (globally and per-project), inspect usage statistics to understand which servers are actually used, and safely remove unused servers with automatic backups. The tool supports commands to list configured servers, view usage statistics with visual indicators, and interactively remove unused servers (with an option to limit scope to unused and to back up nearby configuration files before changes).

By running mcp-tidy list you can quickly see a summary of all MCP servers in scope, including their type, scope, and associated command or path. The stats command provides per-server call counts and recency of last use, giving you a sense of which servers are actively used. If you decide some servers are no longer needed, you can run mcp-tidy remove to interactively select servers to delete, with automatic backups of the Claude configuration to protect against accidental removal.

Prerequisites:

• A supported operating system (macOS or Linux) with a Rust/Go toolchain or prebuilt binaries available for mcp-tidy.
• Internet access to download the binary or to build from source.

Installation options:

1. Homebrew (macOS/Linux)

   • brew install nnnkkk7/tap/mcp-tidy

2. Go install (latest release)

   • go install github.com/nnnkkk7/mcp-tidy/cmd/mcp-tidy@latest

3. From source

   • git clone https://github.com/nnnkkk7/mcp-tidy.git
   • cd mcp-tidy
   • make install

4. Download binary

   • Download the latest binary from GitHub Releases and place it in your PATH.

After installation, verify:

• Run mcp-tidy version (or mcp-tidy --help) to confirm the tool is installed and accessible.

Notes and tips:

• mcp-tidy reads and analyzes Claude Code's transcript logs and the ~/.claude.json file to determine configuration and usage. It supports both global MCP servers and project-scoped servers.
• Before removing any servers, a timestamped backup is created (e.g., ~/.claude.json.backup.YYYYMMDD-HHMMSS). You can restore it if needed.
• Current support is Claude Code only. Other MCP clients (Claude Desktop, Cursor, etc.) are not yet supported.
• If you see path or encoding issues for non-ASCII project paths, consider running with a locale that supports those characters or adjust the path configuration accordingly.