mcp-debug

Diagnose MCP Server issues by analyzing frameworks and permission errors.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues with MCP Server functionalities, including framework analysis, permission problems, and general error diagnostics.

Core Features & Use Cases

  • Connection Diagnostics: Checks if the MCP Server is connected and responsive.
  • Framework Identification: Determines the underlying framework (AppleScript, EventKit, etc.) for targeted debugging.
  • Permission Troubleshooting: Guides users through resolving common permission errors, especially for EventKit-based skills.
  • Use Case: If che-ical-mcp is failing to create calendar events, this Skill can help identify if it's a permission issue with the Calendar app or a code-related problem.

Quick Start

Use the mcp-debug skill to debug the che-ical-mcp server and provide the error message 'permission denied'.

Frequently Asked Questions about mcp-debug

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

FAQPage Schema
How do I debug an MCP Server connection that is failing or unresponsive?

To debug an MCP Server connection, you analyze project source code and system preferences, which provides step-by-step troubleshooting guidance to identify responsiveness issues and resolve underlying errors.

Why does my EventKit MCP server return a permission denied error?

EventKit permission denied errors occur when system access is blocked, which requires permission troubleshooting by checking system preferences and guiding the app to request proper Calendar access for resolving the error.

How do I identify the underlying framework of an MCP Server for targeted troubleshooting?

Framework identification determines the underlying system like AppleScript or EventKit, which enables targeted debugging by analyzing framework types within the project source code to provide comprehensive error resolution.

What do I need to diagnose MCP Server permission issues and compile code?

Diagnosing MCP Server permission issues requires access to project source code, system preferences, and command-line tools, which enables diagnostics and code compilation for comprehensive error resolution.

How do I fix an AppleScript MCP server that fails to execute commands?

Fixing an AppleScript MCP server involves analyzing framework types and identifying permission issues, which provides step-by-step troubleshooting guidance for comprehensive error resolution across supported frameworks.