CodeRabbit

Servidor MCP CodeRabbit

Um servidor Model Context Protocol (MCP) para interagir com as revisões de IA do CodeRabbit em pull requests do GitHub. Este servidor permite que Grandes Modelos de Linguagem (LLMs) analisem, compreendam e implementem sugestões do CodeRabbit programaticamente.

Recursos

• Obter Revisões do CodeRabbit: Recupere todas as revisões do CodeRabbit para um pull request específico
• Detalhes da Revisão: Obtenha informações detalhadas sobre revisões específicas, incluindo configuração e arquivos revisados
• Extrair Comentários: Obtenha comentários individuais de linha com prompts e sugestões de IA
• Detalhes do Comentário: Aprofunde-se em comentários específicos com contexto e exemplos de correção
• Resolver Comentários: Marque comentários como resolvidos, não corrigidos ou não aplicáveis
• Prompt de Fluxo de Trabalho Automatizado: Use o comando de barra /coderabbit-review para processamento completo de revisões

Início Rápido

Instalação (NPX - Recomendado)

Nenhuma instalação necessária! Execute diretamente com npx:

# Install the latest stable version explicitly
npx coderabbitai-mcp@latest

Pré-requisitos

1. Token de Acesso Pessoal do GitHub: Crie em https://github.com/settings/tokens
   • Escopos necessários: repo (para repositórios privados) ou public_repo (apenas para públicos)
2. Node.js 18+: Necessário para executar o servidor

Configuração

Configuração do Claude Desktop

Para usar o servidor MCP CodeRabbit no Claude Desktop, adicione-o ao seu arquivo de configuração:

Locais do arquivo de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuração passo a passo:

1. Abra seu arquivo de configuração do Claude Desktop (crie-o se não existir)
2. Adicione a configuração do servidor MCP CodeRabbit:

{
  "mcpServers": {
    "coderabbitai": {
      "command": "npx",
      "args": ["coderabbitai-mcp@latest"],
      "env": {
        "GITHUB_PAT": "ghp_your_token_here"
      }
    }
  }
}

3. Substitua ghp_your_token_here pelo seu Token de Acesso Pessoal do GitHub real
4. Salve o arquivo e reinicie o Claude Desktop

Configuração do Claude Code

Para usar o servidor MCP CodeRabbit no Claude Code, configure-o no seu projeto:

Configuração passo a passo:

1. Crie um diretório .claude na raiz do seu projeto (se não existir):

   mkdir .claude
   

2. Crie ou edite .claude/config.json:

{
  "mcpServers": {
    "coderabbitai": {
      "command": "npx",
      "args": ["coderabbitai-mcp@latest"],
      "env": {
        "GITHUB_PAT": "ghp_your_token_here"
      }
    }
  }
}

3. Substitua ghp_your_token_here pelo seu Token de Acesso Pessoal do GitHub real
4. O servidor estará disponível na próxima vez que você iniciar o Claude Code neste projeto

Dica profissional: Por segurança, você pode usar variáveis de ambiente em vez de codificar o token:

{
  "mcpServers": {
    "coderabbitai": {
      "command": "npx",
      "args": ["coderabbitai-mcp@latest"],
      "env": {
        "GITHUB_PAT": "${GITHUB_PAT}"
      }
    }
  }
}

Em seguida, defina a variável de ambiente GITHUB_PAT no seu shell antes de iniciar o Claude Code.

Uso

Processamento Automatizado de Revisões (Recomendado)

Use o prompt MCP integrado para automação completa do fluxo de trabalho:

/coderabbit-review owner:bradthebeeble repo:wiseguys pullNumber:15

Este prompt automaticamente:

• Encontra e analisa revisões do CodeRabbit
• Classifica problemas por prioridade (alta/média/baixa)
• Obtém sua aprovação antes de fazer alterações
• Implementa correções sistematicamente
• Marca comentários resolvidos no CodeRabbit
• Fornece um resumo de conclusão

Uso Manual de Ferramentas

{
  "owner": "bradthebeeble",
  "repo": "wiseguys", 
  "pullNumber": 15
}

{
  "owner": "bradthebeeble",
  "repo": "wiseguys",
  "pullNumber": 15,
  "reviewId": 2969007538
}

{
  "owner": "bradthebeeble",
  "repo": "wiseguys",
  "pullNumber": 15,
  "reviewId": 2969007538
}

{
  "owner": "bradthebeeble",
  "repo": "wiseguys",
  "commentId": 2173534099
}

{
  "owner": "bradthebeeble", 
  "repo": "wiseguys",
  "commentId": 2173534099,
  "resolution": "addressed",
  "note": "Implemented asyncHandler wrapper as suggested"
}

git clone https://github.com/bradthebeeble/coderabbitai-mcp.git
cd coderabbitai-mcp
npm install
npm run build

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

# Clean build files
npm run clean

# Test the server
npm test

# GitHub Configuration (shorter variable name)
GITHUB_PAT=ghp_your_token_here

# Optional: CodeRabbit MCP Configuration
CODERABBIT_LOG_LEVEL=info

CODERABBIT_LOG_LEVEL=debug npx coderabbitai-mcp

Requisitos de Integração

Clientes de IA Suportados

• Claude Desktop: Suporte completo com configuração
• Claude Code: Integração MCP em nível de projeto com prompt /coderabbit-review
• Outros Clientes MCP: Qualquer cliente que suporte o Model Context Protocol

Autenticação

O Token de Acesso Pessoal do GitHub precisa destas permissões:

• repo (para repositórios privados) ou public_repo (apenas para públicos)
• read:org (se acessar repositórios de organizações)

Arquitetura

• TypeScript: Implementação totalmente tipada com validação Zod
• SDK MCP: Construído sobre o SDK oficial do Model Context Protocol
• Design Modular: Cada ferramenta é implementada em seu próprio módulo
• Prompts MCP: Fluxos de trabalho automatizados disponíveis como comandos de barra

Limites de Taxa da API

O servidor respeita os limites de taxa da API do GitHub:

• 5.000 solicitações/hora para solicitações autenticadas
• Lida automaticamente com respostas de limite de taxa

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso: git checkout -b feature-name
3. Faça suas alterações e adicione testes
4. Execute o build: npm run build
5. Envie um pull request

Licença

MIT

Suporte

• Problemas: GitHub Issues
• Discussões: GitHub Discussions
• Documentação: Exemplos completos disponíveis em EXAMPLES.md