mcp-github-recovery

What problem does it solve?

This Skill resolves issues where GitHub MCP (Model Context Protocol) calls fail due to transport or authentication errors, specifically when the gh CLI tool is still functional, and Lucky requires its Codex or OpenCode GitHub automation to be restored.

Core Features & Use Cases

• Diagnose MCP Failures: Identifies specific error signatures indicating transport or auth issues with GitHub MCP.
• Validate Configuration: Checks local Codex MCP configuration for GitHub, ensuring correct paths and absence of sensitive environment variables.
• Install Official Binary: Downloads and installs the latest official github-mcp-server binary.
• Update Wrappers: Modifies or creates wrapper scripts (run-mcp-github.sh) for Codex, OpenCode, and Cursor to use the official binary and fall back to gh tokens.
• Smoke Testing: Verifies that Codex and OpenCode can successfully execute GitHub MCP calls after the recovery process.
• Use Case: When your development environment's automated issue tracking or PR creation via MCP stops working, but you can still use gh pr list from your terminal, this Skill guides you through fixing the underlying MCP service.

Quick Start

Run the mcp-github-recovery skill to fix GitHub MCP automation failures.