What is Mcp Pr Reviewer

mcp-pr-reviewer is an intelligent assistant designed for analyzing Pull Requests (PRs) that integrates GitHub with Notion for automated documentation of reviews.

Use cases

Use cases include automating the review process for Pull Requests, generating structured documentation for code changes, and enhancing collaboration between developers and documentation teams.

How to use

To use mcp-pr-reviewer, clone the repository, set up a virtual environment, install dependencies, configure environment variables with your GitHub and Notion tokens, and run the PR analyzer script to start the analysis.

Key features

Key features include automatic analysis of GitHub Pull Requests, integration with Notion for structured documentation, an MCP (Model-Controller-Provider) interface for efficient processing, detailed code change analysis, and automatic documentation generation in Notion.

Where to use

mcp-pr-reviewer can be used in software development environments where Pull Requests are frequently reviewed, particularly in teams utilizing GitHub for version control and Notion for documentation.

PR Reviewer 🔍

Um assistente inteligente para análise de Pull Requests que integra GitHub com Notion para documentação automatizada de revisões.

🌟 Características

• Análise automática de Pull Requests do GitHub
• Integração com Notion para documentação estruturada
• Interface MCP (Model-Controller-Provider) para processamento eficiente
• Suporte a análise detalhada de mudanças de código
• Geração automática de documentação no Notion

🚀 Começando

Pré-requisitos

• Python 3.8 ou superior
• Conta no GitHub com token de acesso
• Conta no Notion com permissões de API
• Tokens de acesso configurados

Instalação

1. Clone o repositório:

git clone [seu-repositorio]
cd pr_reviewer

2. Crie e ative um ambiente virtual:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# ou
.venv\Scripts\activate  # Windows

3. Instale as dependências:

pip install -r requirements.txt

4. Configure as variáveis de ambiente:
   Crie um arquivo .env com as seguintes variáveis:

NOTION_API_KEY=seu_token_do_notion
NOTION_PAGE_ID=id_da_pagina_notion
GITHUB_TOKEN=seu_token_do_github

💻 Uso

Para iniciar o analisador de PRs:

python pr_analyzer.py

O serviço irá:

1. Inicializar o servidor MCP para análise de PRs
2. Estabelecer conexão com a API do GitHub
3. Configurar a integração com o Notion
4. Aguardar solicitações de análise de PRs
5. Gerar documentação automaticamente no Notion

🛠️ Arquitetura

O projeto é estruturado em dois componentes principais:

• pr_analyzer.py: Core da aplicação que gerencia o servidor MCP e coordena as análises
• github_integration.py: Módulo responsável pela integração com a API do GitHub

Componentes

PR Analyzer

• Inicializa o servidor FastMCP
• Gerencia a integração com o Notion
• Registra ferramentas para análise de PRs
• Processa as solicitações de análise

GitHub Integration

• Gerencia a comunicação com a API do GitHub
• Recupera informações de Pull Requests
• Processa mudanças de código

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👥 Contribuição

Contribuições são bem-vindas! Por favor, sinta-se à vontade para submeter PRs.

1. Faça um Fork do projeto
2. Crie sua Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a Branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📞 Suporte

Se você encontrar algum problema ou tiver sugestões, por favor abra uma issue no repositório.