neufagents/mcp-triage

Overview

Triage broken MCP setups across 8 agent clients, identifying what is wrong, fixing what is fixable, and escalating the rest. Provides a CLI and a stdio MCP server in serve mode, with zero runtime dependencies. Written in TypeScript.

Best for

Best for
Developers who manage MCP configurations across multiple agent clients and need a quick diagnostic and repair tool.

Use cases

• Diagnose MCP configuration errors across multiple agent clients
• Automate common fixes for broken MCP setups in CI or local workflows
• Escalate unresolved MCP issues for manual investigation

How to use

Install

npx mcp-triage            # scan standard locations (all clients) + project configs in cwd

Tested with

Claude Desktop, Claude Code, Cursor, Windsurf, VS Code

Notes

Triage broken MCP setups across 8 agent clients, identifying what is wrong, fixing what is fixable, and escalating the rest. Provides a CLI and a stdio MCP server in serve mode, with zero runtime dependencies. Written in TypeScript.

0 stars on GitHub. Last updated 2026-09-19. Licensed MIT.

Use cases

• Diagnose MCP configuration errors across multiple agent clients
• Automate common fixes for broken MCP setups in CI or local workflows
• Escalate unresolved MCP issues for manual investigation

Pros

• Zero runtime dependencies simplifies installation and deployment
• Dual interface supports both direct CLI use and MCP server integration
• Covers 8 agent clients in one tool

Cons

• Only fixes a subset of issues, leaving the rest for manual escalation
• No community adoption signals yet, given zero stars
• Client-specific details are not documented in the provided facts

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.