revibe-mcp

revibe-mcp

用于分析 Revibe 代码库的 MCP 服务。适用于 Claude Desktop、Cursor、Windsurf 及任何兼容 MCP 的客户端。

分析任意 GitHub 仓库，获取架构、文件作用、执行流程、系统设计问答和结构化 Agent 上下文。

快速开始（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 配置

身份验证

有两种方式：

选项 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 获取密钥，然后通过环境变量传入：

{
  "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 Agent 优化的完整结构化 JSON

使用方法

配置完成后，只需向 AI 助手提出请求：

• “使用 Revibe 分析这个仓库”
• “github.com/user/repo 的架构是什么？”
• “获取这个代码库的 Agent 上下文”

这些工具会自动处理检测、轮询和结构化输出。

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，可以将 Revibe 安装为斜杠命令技能，以替代或补充 MCP 服务：

# 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