Skills
.Work. You
Rest

gem-llm-debug-mcp

Community

Fix MCP server issues fast.

Software Engineering#troubleshooting#claude code#mcp#npx#settings.json#log inspection#token auth
Authorsaintgo7
Version1.0.0
Installs0

System Documentation

What problem does it solve?

gem-llm-debug-mcp helps you diagnose why an MCP (Model Context Protocol) server fails to start or connect, why MCP tools don’t appear, or why specific MCP servers (like GitHub, filesystem, Firecrawl, or Mermaid) are misconfigured.

Core Features & Use Cases

  • MCP configuration verification: Checks ~/.claude/settings.json for valid mcpServers definitions (command/args/env) and detects placeholder tokens that were never replaced.
  • Package resolution checks: Uses npx -y <package> --help dry-runs to confirm the MCP server package name and availability.
  • Runtime log inspection & symptom-based branching: Finds relevant Claude Code MCP logs and tail-checks stderr to map symptoms to likely root causes (missing tools, permission errors, GitHub 401/403, npx hangs).

Quick Start

Tell the AI to debug your MCP startup and tool-listing problem by analyzing your ~/.claude/settings.json, running npx -y <mcp-package> --help resolution checks, and then locating and tailing the relevant MCP-related logs for the failure symptom you observe.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: gem-llm-debug-mcp
Download link: https://github.com/saintgo7/claude-skills/archive/main.zip#gem-llm-debug-mcp

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.