mcpproxy-debug

Community

Diagnose MCPProxy issues, restore server health.

Authortechnicalpickles
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a structured, automated approach to debug, configure, and troubleshoot MCPProxy (Model Context Protocol Proxy) servers. It automates diagnostic steps, intelligently identifies common error patterns, and offers immediate solutions, significantly reducing the time and complexity of resolving proxy-related issues.

Core Features & Use Cases

  • Automated Status Checks: Quickly verifies MCPProxy server status, connectivity, and tool availability via API and process checks, giving you an instant overview of your proxy's health.
  • Intelligent Error Diagnosis: Analyzes server-specific logs for common error patterns like "unexpected argument" or "not a TTY", providing immediate root cause analysis and targeted fixes.
  • Configuration Remediation: Guides you through fixing common configuration mistakes for uvx, npx, and Docker-based servers, including critical Docker isolation settings, ensuring your servers connect reliably.
  • Use Case: An MCP server fails to connect. Use this skill to run diagnose_server.sh, which automatically checks logs, identifies a "TTY" error, and suggests adding "isolation": {"enabled": false} to the server config, resolving the issue in minutes instead of hours of manual log digging.

Quick Start

Use the mcpproxy-debug skill to diagnose the 'buildkite' MCP server.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 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: mcpproxy-debug
Download link: https://github.com/technicalpickles/dotfiles/archive/main.zip#mcpproxy-debug

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 223,000+ vetted skills library on demand.