CodeRabbit
Interactúa con las revisiones de IA de CodeRabbit en solicitudes de extracción de GitHub.
Documentación
Servidor MCP de CodeRabbit
Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con las revisiones de IA de CodeRabbit en solicitudes de extracción de GitHub. Este servidor permite que los Modelos de Lenguaje de Gran Escala (LLM) analicen, comprendan e implementen sugerencias de CodeRabbit de manera programática.
Características
- Obtener revisiones de CodeRabbit: Recupera todas las revisiones de CodeRabbit para una solicitud de extracción específica
- Detalles de la revisión: Obtén información detallada sobre revisiones específicas, incluida la configuración y los archivos revisados
- Extraer comentarios: Obtén comentarios de línea individuales con indicaciones y sugerencias de IA
- Detalles del comentario: Profundiza en comentarios específicos con contexto y ejemplos de corrección
- Resolver comentarios: Marca comentarios como abordados, no se corregirá o no aplica
- Indicación de flujo de trabajo automatizado: Usa el comando de barra diagonal
/coderabbit-reviewpara el procesamiento completo de revisiones
Inicio rápido
Instalación (NPX - Recomendado)
¡No se requiere instalación! Ejecuta directamente con npx:
# Install the latest stable version explicitly
npx coderabbitai-mcp@latest
Requisitos previos
- Token de acceso personal de GitHub: Crea uno en https://github.com/settings/tokens
- Ámbitos requeridos:
repo(para repositorios privados) opublic_repo(solo para públicos)
- Ámbitos requeridos:
- Node.js 18+: Requerido para ejecutar el servidor
Configuración
Configuración de Claude Desktop
Para usar el servidor MCP de CodeRabbit en Claude Desktop, agrégalo a tu archivo de configuración:
Ubicaciones del archivo de configuración:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Configuración paso a paso:
- Abre tu archivo de configuración de Claude Desktop (créalo si no existe)
- Agrega la configuración del servidor MCP de CodeRabbit:
{
"mcpServers": {
"coderabbitai": {
"command": "npx",
"args": ["coderabbitai-mcp@latest"],
"env": {
"GITHUB_PAT": "ghp_your_token_here"
}
}
}
}
- Reemplaza
ghp_your_token_herecon tu Token de acceso personal de GitHub real - Guarda el archivo y reinicia Claude Desktop
Configuración de Claude Code
Para usar el servidor MCP de CodeRabbit en Claude Code, configúralo en tu proyecto:
Configuración paso a paso:
-
Crea un directorio
.claudeen la raíz de tu proyecto (si no existe):mkdir .claude -
Crea o edita
.claude/config.json:
{
"mcpServers": {
"coderabbitai": {
"command": "npx",
"args": ["coderabbitai-mcp@latest"],
"env": {
"GITHUB_PAT": "ghp_your_token_here"
}
}
}
}
- Reemplaza
ghp_your_token_herecon tu Token de acceso personal de GitHub real - El servidor estará disponible la próxima vez que inicies Claude Code en este proyecto
Consejo profesional: Por seguridad, puedes usar variables de entorno en lugar de codificar el token:
{
"mcpServers": {
"coderabbitai": {
"command": "npx",
"args": ["coderabbitai-mcp@latest"],
"env": {
"GITHUB_PAT": "${GITHUB_PAT}"
}
}
}
}
Luego establece la variable de entorno GITHUB_PAT en tu shell antes de iniciar Claude Code.
Uso
Procesamiento automatizado de revisiones (Recomendado)
Usa la indicación MCP integrada para la automatización completa del flujo de trabajo:
/coderabbit-review owner:bradthebeeble repo:wiseguys pullNumber:15
Esta indicación automáticamente:
- Encuentra y analiza las revisiones de CodeRabbit
- Clasifica los problemas por prioridad (alta/media/baja)
- Obtiene tu aprobación antes de realizar cambios
- Implementa correcciones sistemáticamente
- Marca comentarios resueltos en CodeRabbit
- Proporciona un resumen de finalización
Uso manual de herramientas
Herramientas disponibles
1. get_coderabbit_reviews
Obtén todas las revisiones de CodeRabbit para una solicitud de extracción específica.
{
"owner": "bradthebeeble",
"repo": "wiseguys",
"pullNumber": 15
}
2. get_review_details
Obtén información detallada sobre una revisión específica de CodeRabbit.
{
"owner": "bradthebeeble",
"repo": "wiseguys",
"pullNumber": 15,
"reviewId": 2969007538
}
3. get_review_comments
Obtén todos los comentarios de línea individuales de las revisiones de CodeRabbit.
{
"owner": "bradthebeeble",
"repo": "wiseguys",
"pullNumber": 15,
"reviewId": 2969007538
}
4. get_comment_details
Obtén información detallada sobre un comentario específico de CodeRabbit.
{
"owner": "bradthebeeble",
"repo": "wiseguys",
"commentId": 2173534099
}
5. resolve_comment
Marca un comentario de CodeRabbit como resuelto.
{
"owner": "bradthebeeble",
"repo": "wiseguys",
"commentId": 2173534099,
"resolution": "addressed",
"note": "Implemented asyncHandler wrapper as suggested"
}
Instalación para desarrollo
Para desarrollo o personalización local:
git clone https://github.com/bradthebeeble/coderabbitai-mcp.git
cd coderabbitai-mcp
npm install
npm run build
Comandos de desarrollo
# Build TypeScript
npm run build
# Watch mode for development
npm run dev
# Clean build files
npm run clean
# Test the server
npm test
Variables de entorno
Crea un archivo .env (opcional):
# GitHub Configuration (shorter variable name)
GITHUB_PAT=ghp_your_token_here
# Optional: CodeRabbit MCP Configuration
CODERABBIT_LOG_LEVEL=info
Solución de problemas
Problemas comunes
El servidor no carga (NPX):
- Verifica que Node.js 18+ esté instalado:
node --version - Prueba la ejecución manual de npx:
npx coderabbitai-mcp - Verifica tu conexión a internet (npx descarga la última versión)
Errores de la API de GitHub:
- Verifica que tu token de GitHub tenga los permisos requeridos
- Comprueba que tengas acceso a los repositorios que estás consultando
No se encontraron revisiones de CodeRabbit:
- Verifica que la solicitud de extracción tenga revisiones de CodeRabbit (consulta la interfaz web de GitHub)
- Asegúrate de usar el propietario/repositorio/númeroDeSolicitud correctos
Modo de depuración
Habilita el registro de depuración:
CODERABBIT_LOG_LEVEL=debug npx coderabbitai-mcp
Requisitos de integración
Clientes de IA compatibles
- Claude Desktop: Soporte completo con configuración
- Claude Code: Integración MCP a nivel de proyecto con la indicación
/coderabbit-review - Otros clientes MCP: Cualquier cliente que admita el Protocolo de Contexto de Modelo
Autenticación
El Token de acceso personal de GitHub necesita estos permisos:
repo(para repositorios privados) opublic_repo(solo para públicos)read:org(si se accede a repositorios de organizaciones)
Arquitectura
- TypeScript: Implementación completamente tipada con validación Zod
- SDK MCP: Construido sobre el SDK oficial del Protocolo de Contexto de Modelo
- Diseño modular: Cada herramienta se implementa en su propio módulo
- Indicaciones MCP: Flujos de trabajo automatizados disponibles como comandos de barra diagonal
Límites de velocidad de la API
El servidor respeta los límites de velocidad de la API de GitHub:
- 5,000 solicitudes/hora para solicitudes autenticadas
- Maneja automáticamente las respuestas de límite de velocidad
Contribuciones
- Haz un fork del repositorio
- Crea una rama de características:
git checkout -b feature-name - Realiza tus cambios y agrega pruebas
- Ejecuta la compilación:
npm run build - Envía una solicitud de extracción
Licencia
MIT
Soporte
- Problemas: Problemas de GitHub
- Discusiones: Discusiones de GitHub
- Documentación: Ejemplos completos disponibles en EXAMPLES.md