mcp-diagnose

Diagnose MCP Server connection issues by checking connectivity and binary status.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/PsychQuant/psychquant-claude-plugins --skill mcp-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-diagnose
Source: https://github.com/PsychQuant/psychquant-claude-plugins/tree/main/plugins/mcp-tools/skills/mcp-diagnose
Command: npx skills add https://github.com/PsychQuant/psychquant-claude-plugins --skill mcp-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps troubleshoot and diagnose connection problems with MCP Servers, ensuring your tools can communicate effectively.

Core Features & Use Cases

  • Connection Status Check: Verifies if the MCP Server is reachable and connected.
  • Basic Functionality Test: Performs a simple read-only call to confirm server responsiveness.
  • Binary Path Identification: Assists in locating the MCP Server binary for further inspection.
  • Use Case: If your che-things-mcp tool is not responding, use this Skill to quickly determine if it's a connection issue or a deeper problem.

Quick Start

Run the mcp-diagnose skill to check the connection for che-ical-mcp.

Frequently Asked Questions about mcp-diagnose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug an MCP Server connection failure with Claude Code?

Troubleshooting MCP Server connection issues involves verifying server reachability, checking binary path configurations, and executing basic read-only function calls to confirm the server is actively responding to requests.

Why does my MCP Server tool not respond when called?

An MCP Server tool fails to respond when the connection is broken, the binary path is invalid, or communication with Claude Code is interrupted, requiring a diagnostic check to isolate the specific failure point.

Can I test MCP Server responsiveness without running a full operation?

Yes, you can test MCP Server responsiveness by performing a simple read-only function call to verify connectivity and confirm the server is actively communicating without triggering a full operational workflow.

What is the best way to check if an MCP Server binary is correctly configured?

The best way to check MCP Server binary configuration is by running a diagnostic process that identifies the binary path and validates its status to ensure the server application is properly located and accessible.

Does this diagnostic Skill work for any MCP Server application?

This diagnostic Skill works for any MCP Server application experiencing communication failures with Claude Code by checking general connectivity, binary status, and basic function responses regardless of the specific implementation.