revibe-mcp

revibe-mcp

MCP server for Revibe codebase analysis. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Analyze any GitHub repo — get architecture, file roles, execution flows, system design Q&A, and structured agent context.

Quick Start (Node.js — zero install)

Add to your MCP client config:

{
  "mcpServers": {
    "revibe": {
      "command": "npx",
      "args": ["revibe-mcp"]
    }
  }
}

Then ask your AI assistant to "log in to Revibe" — it will open your browser for a one-time signup.

Quick Start (Python)

pip install revibe-mcp
revibe-mcp-auth login

{
  "mcpServers": {
    "revibe": {
      "command": "revibe-mcp"
    }
  }
}

Where to add the config

Client	Config location
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code	.mcp.json in your project root
Cursor	Settings > MCP Servers > Add
Windsurf	MCP config in settings

Auth

Two options:

Option A: Browser login (recommended)

# Node.js
npx revibe-mcp-auth login

# Python
revibe-mcp-auth login

Opens your browser — sign up or log in, click "Authorize". API key saved automatically to ~/.config/revibe/credentials.json.

Option B: Manual API key

Get a key from revibe.codes/settings, then pass it via env:

{
  "mcpServers": {
    "revibe": {
      "command": "npx",
      "args": ["revibe-mcp"],
      "env": {
        "REVIBE_API_KEY": "rk_live_your_key_here"
      }
    }
  }
}

Tools

Tool	Description
revibe_login	Log in via browser — one-time setup
analyze_repo	Submit a GitHub repo for analysis (auto-detects from git remote)
check_status	Check progress of an analysis job
get_summary	Architecture, modules, patterns overview
get_section	Drill into architecture, file_roles, system_design_qa, etc.
get_agent_context	Full structured JSON optimized for AI agents

Usage

Once configured, just ask your AI assistant:

• "Analyze this repo with Revibe"
• "What's the architecture of github.com/user/repo?"
• "Get the agent context for this codebase"

The tools handle auto-detection, polling, and structured output automatically.

CLI Commands

# Node.js
npx revibe-mcp-auth login     # Log in via browser
npx revibe-mcp-auth status    # Show current auth status
npx revibe-mcp-auth logout    # Remove saved credentials

# Python
revibe-mcp-auth login
revibe-mcp-auth status
revibe-mcp-auth logout

Packages

Registry	Package	Install
npm	revibe-mcp	npx revibe-mcp
PyPI	revibe-mcp	pip install revibe-mcp

License

MIT