{"_id":"@ajay.j_dev/mcpmg","name":"@ajay.j_dev/mcpmg","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@ajay.j_dev/mcpmg","version":"1.0.0","description":"Unified CLI & TUI tool for monitoring, managing, diagnosing, and auto-fixing Model Context Protocol (MCP) servers across all AI hosts.","type":"module","bin":{"mcpmg":"dist/cli.js"},"repository":{"type":"git","url":"git+https://github.com/AJAYMYTH/MCPmg.git"},"bugs":{"url":"https://github.com/AJAYMYTH/MCPmg/issues"},"homepage":"https://github.com/AJAYMYTH/MCPmg#readme","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","watch":"tsc -w","typecheck":"tsc --noEmit","test":"node scripts/run-tests.js","pretest":"npm run build","start":"node dist/cli.js"},"keywords":["mcp","model-context-protocol","claude","cursor","antigravity","gemini","ai","cli","tui","monitor","manager","devtools"],"author":{"name":"AJAYMYTH"},"license":"MIT","dependencies":{"@clack/prompts":"^0.9.1","@modelcontextprotocol/sdk":"^1.6.1","cli-table3":"^0.6.5","commander":"^13.1.0","ink":"^5.2.1","ora":"^8.2.0","picocolors":"^1.1.1","react":"^18.3.1","termui":"^1.5.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.9","@types/react":"^18.3.31","typescript":"^5.8.2"},"gitHead":"e52ee13c95bc7528a01712e90a6c2b48d68977ed","_id":"@ajay.j_dev/mcpmg@1.0.0","_nodeVersion":"24.17.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-SDUX47vgm67yIDrvPesFg+FEAf7Cn2/vRUtAGxGTBR1jnbmjOymBirFUlQkTjd91dxXqRtB07sRbBquUzIN7Vg==","shasum":"e23d74119cfc6726d71e1d2dc757067c1f4f636c","tarball":"https://registry.npmjs.org/@ajay.j_dev/mcpmg/-/mcpmg-1.0.0.tgz","fileCount":96,"unpackedSize":380071,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCLTYb8aX4I4kbby+1VsVusTEjrPTQtZG1mEyx9bFAYGQIgQ2Qng95teddp99j9LMblBhQJkzmM/+0JSs+hGYlSezY="}]},"_npmUser":{"name":"ajay.j_dev","email":"javaliajayakumar8574@gmail.com"},"directories":{},"maintainers":[{"name":"ajay.j_dev","email":"javaliajayakumar8574@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcpmg_1.0.0_1789036634176_0.54016682078482"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-10T10:37:13.929Z","1.0.0":"2026-09-10T10:37:14.303Z","modified":"2026-09-10T10:37:14.547Z"},"maintainers":[{"name":"ajay.j_dev","email":"javaliajayakumar8574@gmail.com"}],"description":"Unified CLI & TUI tool for monitoring, managing, diagnosing, and auto-fixing Model Context Protocol (MCP) servers across all AI hosts.","homepage":"https://github.com/AJAYMYTH/MCPmg#readme","keywords":["mcp","model-context-protocol","claude","cursor","antigravity","gemini","ai","cli","tui","monitor","manager","devtools"],"repository":{"type":"git","url":"git+https://github.com/AJAYMYTH/MCPmg.git"},"author":{"name":"AJAYMYTH"},"bugs":{"url":"https://github.com/AJAYMYTH/MCPmg/issues"},"license":"MIT","readme":"<div align=\"center\">\r\n\r\n```\r\n  ███╗   ███╗ ██████╗██████╗ ███╗   ███╗ ██████╗ \r\n  ████╗ ████║██╔════╝██╔══██╗████╗ ████║██╔════╝ \r\n  ██╔████╔██║██║     ██████╔╝██╔████╔██║██║  ███╗\r\n  ██║╚██╔╝██║██║     ██╔═══╝ ██║╚██╔╝██║██║   ██║\r\n  ██║ ╚═╝ ██║╚██████╗██║     ██║ ╚═╝ ██║╚██████╔╝\r\n  ╚═╝     ╚═╝ ╚═════╝╚═╝     ╚═╝     ╚═╝ ╚═════╝ \r\n```\r\n\r\n### Model Context Protocol Multi-Host Manager, Diagnostic Doctor & Live Health Monitor\r\n\r\n[![CI](https://github.com/AJAYMYTH/MCPmg/actions/workflows/ci.yml/badge.svg)](https://github.com/AJAYMYTH/MCPmg/actions/workflows/ci.yml)\r\n[![Release](https://img.shields.io/github/v/release/AJAYMYTH/MCPmg?color=blue&logo=github)](https://github.com/AJAYMYTH/MCPmg/releases)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\r\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-339933?logo=node.js)](https://nodejs.org/)\r\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-3178C6?logo=typescript)](https://www.typescriptlang.org/)\r\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\r\n\r\n</div>\r\n\r\n---\r\n\r\n**MCPmg** is a unified, global CLI and full-screen Terminal UI (TUI) tool for managing, monitoring, diagnosing, and auto-repairing [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers across all major AI hosts—including **Claude Desktop**, **Antigravity / Gemini**, **Cursor**, **VS Code (Cline / Roo-Code)**, **Claude Code CLI**, and local project workspaces.\r\n\r\nBuilt with **TypeScript**, **Node.js**, **TermUI**, **Ink**, and the official **`@modelcontextprotocol/sdk`**.\r\n\r\n---\r\n\r\n## Key Features\r\n\r\n- **Multi-Host Discovery**: Automatically detects installed AI clients and parses their configuration files without breaking custom client settings.\r\n- **Full-Screen Interactive TUI (`mcpmg tui`)**: Dual-pane dashboard powered by Ink & React for terminals. Browse servers, inspect configs, trigger targeted doctor audits, deploy server presets, and view snapshot history.\r\n- **Interactive Live Monitor (`mcpmg monitor`)**: Real-time health polling with arrow-key navigation (`[↑/↓]`), on-demand server probe (`[Space/Enter]`), inline doctor diagnosis (`[d]`), and zero-flicker alternate screen buffers (`\\x1b[?1049h`).\r\n- **Responsive Table Engine**: Mathematically boundary-enforced CLI tables that never overflow, wrap, or break borders, strictly optimized for 80-column and split-window terminals.\r\n- **Deep Diagnostic Doctor (`mcpmg doctor`)**: Audits servers for missing auth tokens, expired credentials, Windows binary resolution (`npx` vs `npx.cmd`), JSON schema violations, and runtime crash logs.\r\n- **Interactive Auto-Fixer (`mcpmg fix`)**: One-command interactive repair wizard that prompts for missing tokens, repairs executable extensions, and verifies connectivity.\r\n- **Safeguards & Attention Notices**: Displays high-visibility attention notices with exact action impacts and requires explicit confirmation before any file modification.\r\n- **Automatic Configuration Snapshots (`mcpmg backup`)**: Timestamped backups are preserved in `~/.mcpmg/backups/` before any mutation, with instant rollback support via `mcpmg backup restore`.\r\n- **Cross-Host Sync (`mcpmg sync`)**: Clone and migrate server configurations between AI hosts in a single command.\r\n- **Zero Emojis & Clean Monospace Aesthetic**: Clean, professional UI using glyphs from `sebastiencs/icons-in-terminal` and universal geometric unicode markers.\r\n\r\n---\r\n\r\n## Supported AI Hosts\r\n\r\n| Host | Supported Platforms | Default Configuration Path |\r\n|---|---|---|\r\n| **Claude Desktop** | macOS, Windows | `%APPDATA%\\Claude\\claude_desktop_config.json`<br>`~/Library/Application Support/Claude/claude_desktop_config.json` |\r\n| **Antigravity / Gemini** | All platforms | `~/.gemini/antigravity/mcp_config.json`<br>`~/.gemini/settings.json` |\r\n| **Cursor** | All platforms | `~/.cursor/mcp.json` |\r\n| **VS Code (Cline / Roo)** | All platforms | `%APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json` |\r\n| **Claude Code CLI** | All platforms | `~/.claude.json` |\r\n| **Local Workspace** | All platforms | `./.mcp.json` |\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### Prerequisites\r\n- Node.js `v18.0.0` or higher\r\n- npm `v9.0.0` or higher\r\n\r\n### Install via npm\r\n```bash\r\nnpm install -g @ajay.j_dev/mcpmg\r\n\r\n# Or run instantly without global install\r\nnpx @ajay.j_dev/mcpmg\r\n```\r\n\r\n### Install from Source\r\n```bash\r\ngit clone https://github.com/AJAYMYTH/MCPmg.git\r\ncd mcpmg\r\nnpm install\r\nnpm run build\r\nnpm link\r\n```\r\n\r\nVerify installation:\r\n```bash\r\nmcpmg --version\r\n# Output: 1.0.0\r\n```\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n```bash\r\n# 1. List all servers configured across all AI hosts\r\nmcpmg list\r\n\r\n# 2. Launch the interactive full-screen dashboard\r\nmcpmg tui\r\n\r\n# 3. Launch the real-time live status monitor\r\nmcpmg monitor\r\n\r\n# 4. Probe connectivity and inspect exposed tools\r\nmcpmg test\r\n\r\n# 5. Run a comprehensive diagnostic health check\r\nmcpmg doctor\r\n\r\n# 6. Auto-repair detected issues\r\nmcpmg fix\r\n```\r\n\r\n---\r\n\r\n## Command Reference\r\n\r\n### `mcpmg list`\r\nDisplay a responsive grid of all configured MCP servers across detected AI hosts.\r\n```bash\r\nmcpmg list\r\nmcpmg list --host claude       # Filter to Claude Desktop\r\nmcpmg list --host antigravity  # Filter to Antigravity\r\nmcpmg list --host cursor       # Filter to Cursor\r\n```\r\n\r\n### `mcpmg tui`\r\nLaunch the full-screen terminal dashboard powered by TermUI.\r\n```bash\r\nmcpmg tui\r\n```\r\n**Keyboard Navigation in TUI**:\r\n| Key | Action |\r\n|---|---|\r\n| `[1]` | Switch to **Servers** tab |\r\n| `[2]` | Switch to **Doctor** tab |\r\n| `[3]` | Switch to **Presets** tab |\r\n| `[4]` | Switch to **Backups** tab |\r\n| `[↑ / ↓]` or `[k / j]` | Navigate servers / diagnostic checklist / presets |\r\n| `[Space]` | Toggle server enable / disable |\r\n| `[t]` | Probe connection latency and fetch tools |\r\n| `[d]` | Jump to Doctor diagnosis for selected server |\r\n| `[r]` | Re-run diagnostic audit |\r\n| `[Esc]` or `[q]` | Exit TUI and restore terminal buffer |\r\n\r\n### `mcpmg monitor`\r\nLaunch the interactive real-time status monitor.\r\n```bash\r\nmcpmg monitor\r\nmcpmg monitor --interval 3     # Poll every 3 seconds (default: 5s)\r\nmcpmg monitor --host claude    # Monitor only Claude Desktop servers\r\n```\r\n**Keyboard Navigation in Monitor**:\r\n| Key | Action |\r\n|---|---|\r\n| `[↑ / ↓]` or `[k / j]` | Navigate rows (highlighted with `▶`) |\r\n| `[Space]` or `[Enter]` | Probe highlighted server immediately |\r\n| `[d]` | Run inline Doctor diagnosis on selected server |\r\n| `[Esc]` or `[q]` | Exit monitor and restore terminal buffer |\r\n\r\n### `mcpmg test [name]`\r\nPerform protocol handshakes, calculate round-trip latency, and list exposed tools, resources, and prompts.\r\n```bash\r\nmcpmg test                     # Test all configured servers\r\nmcpmg test taskair             # Test specific server by name\r\nmcpmg test --host cursor       # Test all servers on Cursor\r\n```\r\n\r\n### `mcpmg doctor [name]`\r\nDeep diagnostic audit detecting auth failures, Windows executable path issues, JSON formatting flaws, and process crashes.\r\n```bash\r\nmcpmg doctor                   # Audit all servers\r\nmcpmg doctor supabase          # Audit specific server\r\n```\r\n\r\n### `mcpmg fix [name]`\r\nInteractive repair wizard that prompts for missing tokens, updates command paths, and re-tests connectivity.\r\n```bash\r\nmcpmg fix                      # Audit and interactively repair all detected issues\r\nmcpmg fix supabase             # Repair a specific server\r\n```\r\n\r\n### `mcpmg add [name]`\r\nAdd a new MCP server configuration via interactive wizard or command flags.\r\n```bash\r\nmcpmg add                      # Interactive prompt wizard\r\nmcpmg add memory --preset memory --host claude\r\nmcpmg add my-fs --preset filesystem --host cursor\r\n```\r\n\r\n### `mcpmg remove <name>`\r\nSafely remove an MCP server configuration. Displays Attention Notice and creates an automatic snapshot before removing.\r\n```bash\r\nmcpmg remove my-server\r\nmcpmg remove my-server --host antigravity\r\n```\r\n\r\n### `mcpmg edit <name>`\r\nInteractively update environment variables, arguments, command targets, or toggle enabled/disabled status.\r\n```bash\r\nmcpmg edit taskair\r\n```\r\n\r\n### `mcpmg sync <name>`\r\nClone and synchronize a server configuration from one AI host to another.\r\n```bash\r\nmcpmg sync codebase-memory-mcp --from antigravity --to cursor\r\n```\r\n\r\n### `mcpmg backup`\r\nView configuration snapshots and restore previous backups.\r\n```bash\r\nmcpmg backup list              # View all saved snapshots with dates and sizes\r\nmcpmg backup restore           # Interactively select and restore a backup snapshot\r\n```\r\n\r\n---\r\n\r\n## Responsive Table Engine\r\n\r\nMCPmg features an adaptive table layout engine (`src/utils/tableHelper.ts`) designed to eliminate broken box-drawing borders and edge-wrapping across all terminal widths:\r\n\r\n- **Wide Layout (`>= 105 cols`)**: Full 7-column layout with dynamic details expansion.\r\n- **Medium Layout (`76–104 cols`)**: 6-column layout mathematically capped at **78 columns**, ensuring a clean 2-column margin on standard 80-column terminals. Details are cleanly presented in the dedicated Inspector card below.\r\n- **Compact Layout (`55–75 cols`)**: 4-column layout for narrow split panes.\r\n- **Narrow Layout (`< 55 cols`)**: Individual bordered card layout.\r\n\r\n```\r\n┌────────────────────┬────────────────┬────────┬────────────────────┬────────┐\r\n│ Server             │ Host           │ Type   │ Target             │ Status │\r\n├────────────────────┼────────────────┼────────┼────────────────────┼────────┤\r\n│ taskair            │ Claude Desktop │ STDIO  │ npx.cmd -y taskai… │ ● On   │\r\n├────────────────────┼────────────────┼────────┼────────────────────┼────────┤\r\n│ supabase           │ Antigravity /… │ SSE    │ https://mcp.supab… │ ● On   │\r\n├────────────────────┼────────────────┼────────┼────────────────────┼────────┤\r\n│ codebase-memory-m… │ Antigravity /… │ STDIO  │ C:/Users/javal/Ap… │ ● On   │\r\n└────────────────────┴────────────────┴────────┴────────────────────┴────────┘\r\n```\r\n\r\n---\r\n\r\n## Architecture\r\n\r\n```\r\nsrc/\r\n├── cli.ts               # Commander CLI configuration & command dispatch\r\n├── types.ts             # Domain interfaces (servers, hosts, diagnostics)\r\n├── hosts/\r\n│   ├── hostManager.ts   # Multi-host registry & configuration coordinator\r\n│   ├── baseHost.ts      # Abstract base host adapter\r\n│   ├── claudeDesktop.ts # Claude Desktop config adapter\r\n│   ├── antigravity.ts   # Antigravity / Gemini config adapter\r\n│   ├── cursor.ts        # Cursor config adapter\r\n│   ├── cline.ts         # VS Code Cline / Roo-Code config adapter\r\n│   ├── claudeCode.ts    # Claude Code CLI config adapter\r\n│   ├── workspace.ts     # Local .mcp.json workspace adapter\r\n│   └── backup.ts        # Snapshot manager & rollback handler\r\n├── client/\r\n│   └── mcpRunner.ts     # Protocol client runner (stdio & sse transports)\r\n├── doctor/\r\n│   └── diagnostics.ts   # Deep diagnostic health audit engine\r\n├── fixers/\r\n│   └── fixerRegistry.ts # Auto-repair handlers & prompt resolvers\r\n├── presets/\r\n│   └── popular.ts       # Preset template catalog\r\n├── ui/\r\n│   ├── banner.ts        # Monochrome ASCII logo banner\r\n│   ├── icons.ts         # Terminal icons (icons-in-terminal)\r\n│   └── tui/\r\n│       ├── App.tsx      # TermUI / Ink full-screen application\r\n│       └── views/       # Servers, Doctor, Presets, Backups tabs\r\n├── utils/\r\n│   ├── tableHelper.ts   # ANSI-safe cell truncation & table width math\r\n│   └── attention.ts     # Attention notices & confirmation prompts\r\n└── commands/            # CLI command implementations\r\n```\r\n\r\n---\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please review our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).\r\n\r\n```bash\r\n# Run tests\r\nnpm test\r\n\r\n# Check types\r\nnpm run typecheck\r\n```\r\n\r\n---\r\n\r\n## Security\r\n\r\nSecurity is paramount. MCPmg operates strictly locally, collects zero telemetry, and creates automatic backups before modifying any configuration. Please review our [Security Policy](SECURITY.md) to report vulnerabilities.\r\n\r\n---\r\n\r\n## License\r\n\r\nDistributed under the [MIT License](LICENSE). Copyright (c) 2026 MCPmg Contributors.\r\n","readmeFilename":"README.md","_rev":"1-3af8f9345a71b3703bdea201df3264dd"}