agent-reverse

AgentReverse is an MCP server that analyzes sources (GitHub repos, local configs, articles, or other inputs) to extract capabilities in the form of skills, agents, and MCP servers. It then helps you install only the capabilities you actually need, rather than cloning entire repositories. The server exposes commands to analyze sources, install specific capabilities, audit your setup, synchronize manifests, and back up or restore configurations. Typical workflows include analyzing a source to discover available capabilities, installing a chosen capability (with security checks), and then auditing or backing up your manifest to ensure a clean, portable setup. The MCP tools include functions for managing capability manifests, installing with security gates, checking for updates, and performing backups across different agent platforms.

Prerequisites:

• Node.js v20.0.0 or newer
• npm (comes with Node.js)

Option A: Run via npx (standalone, quickest)

# Add MCP server
claude mcp add agent-reverse -- npx -y @shihwesley/agent-reverse agent-reverse-server

# Install skills and agents (from the MCP server perspective)
npx -y @shihwesley/agent-reverse setup

Option B: Install from source and run locally

# Clone the repository
git clone https://github.com/shihwesley/agent-reverse.git
cd agent-reverse

# Install dependencies and build
npm install && npm run build

# Add MCP server pointing to the built server
claude mcp add agent-reverse -- node dist/server.js

# Set up client-side components if needed
node dist/cli.js setup

Option C: Global install (alternative)

npm install -g @shihwesley/agent-reverse
claude mcp add agent-reverse -- agent-reverse-server
agent-reverse setup

Notes and tips:

• The server supports analyzing various sources to extract capabilities, including GitHub repos and articles. Use /agent-reverse analyze <source> to discover available capabilities.
• Ensure Node.js is version 20.0.0 or newer to avoid compatibility issues.
• After installation, you can use commands such as /agent-reverse install <id>, /agent-reverse audit, /agent-reverse backup, and /agent-reverse restore to manage capabilities and configurations.
• When using npx installation, the command to run the server through Claude Code is configured in the MCP settings (see mcp_config).
• The MCP server exposes capabilities like skills and MCP servers you can install, for example TypeScript language intelligence (typescript-lsp) and Python type checking (pyright-lsp), as shown in the example analyses.
• If you encounter permission or network issues during install, consider running with appropriate flags to allow network access or to bypass strict install checks (respect security prompts in production environments).