revibe-mcp

revibe-mcp

Revibe のコードベースを分析する MCP サーバーです。Claude Desktop、Cursor、Windsurf、および MCP 対応クライアントで利用できます。

GitHub リポジトリを分析し、アーキテクチャ、ファイルの役割、実行フロー、システム設計に関する Q&A、構造化されたエージェントコンテキストを取得できます。

クイックスタート（Node.js — インストール不要）

MCP クライアントの設定に追加します。

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

次に、AI アシスタントに「Revibe にログインして」と頼みます。初回登録のためにブラウザーが開きます。

クイックスタート（Python）

pip install revibe-mcp
revibe-mcp-auth login

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

設定の追加先

クライアント	設定場所
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code	プロジェクトのルートにある .mcp.json
Cursor	Settings > MCP Servers > Add
Windsurf	設定内の MCP config

認証

2 つの方法があります。

方法 A：ブラウザーログイン（推奨）

# Node.js
npx revibe-mcp-auth login

# Python
revibe-mcp-auth login

ブラウザーが開きます。登録またはログインして、「Authorize」をクリックします。API キーは ~/.config/revibe/credentials.json に自動保存されます。

方法 B：API キーを手動で設定

app.revibe.codes/settings からキーを取得し、env 経由で渡します。

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

ツール

ツール	説明
revibe_login	ブラウザーからログインします（初回のみ）
analyze_repo	GitHub リポジトリを分析に送信します（git remote から自動検出）
check_status	分析ジョブの進行状況を確認します
get_summary	アーキテクチャ、モジュール、パターンの概要を取得します
get_section	architecture、file_roles、system_design_qa などを詳しく確認します
get_agent_context	AI エージェント向けに最適化された、構造化 JSON 全体を取得します

使い方

設定が完了したら、AI アシスタントに次のように頼むだけです。

• 「Revibe でこのリポジトリを分析して」
• 「github.com/user/repo のアーキテクチャは？」
• 「このコードベースのエージェントコンテキストを取得して」

ツールは自動検出、ポーリング、構造化された出力を自動的に処理します。

CLI コマンド

# 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

Claude Code スキル

Claude Code をお使いの場合は、MCP サーバーの代わりに、または MCP サーバーに加えて、Revibe をスラッシュコマンドのスキルとしてインストールできます。

# Copy the skill file
mkdir -p ~/.claude/skills/revibe
curl -o ~/.claude/skills/revibe/SKILL.md \
  https://raw.githubusercontent.com/selvatuple/revibe-mcp/main/skills/claude-code/SKILL.md

Claude Code 内で /revibe または /revibe github.com/user/repo を使います。

スキルファイルは skills/claude-code/SKILL.md からも入手できます。

パッケージと配布方法

方法	インストール
npm（インストール不要）	npx revibe-mcp
PyPI	pip install revibe-mcp
MCP Registry	registry.modelcontextprotocol.io — 「revibe」で検索
Claude Code Skill	skills/claude-code/SKILL.md を ~/.claude/skills/revibe/ にコピー

ライセンス

MIT