mcp-tidy

mcp-tidy is a command-line tool designed to help you visualize and manage your MCP server configurations. It provides core capabilities to list linked MCP servers, analyze usage statistics for each server, and perform cleanup to remove unused configurations, keeping your workspace organized. Once installed, you can quickly see all your configured MCP servers, inspect usage patterns, and identify candidates for cleanup to optimize resource usage.

Usage emphasizes three primary commands. Use mcp-tidy list to display all linked servers. Run mcp-tidy stats <server-name> to fetch detailed usage statistics for a specific server. Finally, issue mcp-tidy cleanup to start the cleanup workflow, which prompts for confirmation before removing unused server configurations. This makes it suitable for ongoing maintenance of MCP setups, especially in environments with frequent server churn.

Prerequisites:

• A compatible operating system (Windows, Linux, or macOS).
• Access to download the mcp-tidy binary from its releases page.

Installation steps:

1. Download the appropriate release for your OS from the project releases page.
2. Unzip the downloaded file if necessary:
   • On Windows: unzip and place mcp-tidy.exe in a directory included in your PATH.
   • On Linux/macOS: unzip or extract and move the binary to a directory in your PATH, for example /usr/local/bin.
3. Make sure the binary is executable (if required):
   • chmod +x mcp-tidy
4. Verify installation:
   • Run: mcp-tidy --version
5. Start using the tool:
   • List servers: mcp-tidy list
   • Analyze usage: mcp-tidy stats <server-name>
   • Clean up: mcp-tidy cleanup

Tips and common issues:

• Ensure the binary you downloaded matches your OS architecture (64-bit vs 32-bit).
• If you encounter permission errors on Linux/macOS, run with appropriate permissions or adjust PATH locations.
• The cleanup command prompts for confirmation; ensure you review the suggestions before proceeding to avoid accidental deletions.
• If servers are managed through external configuration sources, verify that mcp-tidy has access to the relevant config directories.
• Regularly check for updates/releases to benefit from improved features and bug fixes.