PR模板推荐工具

一个分析代码变更并自动推荐合适PR模板的开发效率工具,适用于团队协作和代码审查场景。

  • by alexalm-mf
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 alexalm-mf/pr-agent-mcp

使用说明

公关代理mcp

分析更改并为拉取请求建议适当模板的代理。

目录

项目结构

pr-agent-mcp/
├── mcp_server.py           # FastMCP server with PR analysis tools
├── mcp-host_config.json    # Configuration for MCP host
├── start.sh                # Startup script to run both server and host
├── pyproject.toml          # Python dependencies and project metadata
├── uv.lock                 # UV lock file for reproducible installs
├── templates/              # PR template directory
│   ├── bug.md             # Bug fix template
│   ├── docs.md            # Documentation template
│   ├── feature.md         # Feature template
│   ├── performance.md     # Performance improvement template
│   ├── refactor.md        # Refactoring template
│   ├── security.md        # Security fix template
│   └── test.md            # Test template
└── README.md              # This file

文件说明:

  • mcp_server.py:主MCP服务器,提供用于分析git更改、列出PR模板和建议适当模板的工具
  • mcp-host_config json:MCP主机客户端的配置文件
  • start.sh:启动MCP服务器(后台)和MCP主机(前台)的Bash脚本
  • 模板/:包含用于不同类型拉取请求的markdown模板

先决条件

必需

  1. Python 3.10+ 和 紫外线 (Python包安装程序)

    • 安装紫外线:https://docs.astral.sh/uv/getting-started/installation/
  2. 奥拉玛 (用于运行本地LLM)

    • 安装:https://ollama.com/download
  3. 去 (用于安装mcphost)

    • 安装:https://go.dev/doc/install
  4. mcphost (MCP主机客户端)

    • 通过Go安装: go install github.com/mark3labs/mcphost@latest
    • 代表:https://github.com/mark3labs/mcphost

可选的

  1. Node.js和npm (用于检查MCP工具)
    • 安装:https://nodejs.org/en/download
    • 仅当您想使用MCP检查器时才需要

安装

  1. 克隆此存储库:

    git clone https://github.com/alexalm-mf/pr-agent-mcp.git
    cd pr-agent-mcp
    
  2. 使用uv安装Python依赖项:

    uv sync --all-extras
    

用法

运行代理

只需打开终端,使用绝对路径从任何地方运行启动脚本:

./path/to/pr-agent-mcp/start.sh

此脚本将:

  1. 在后台启动MCP服务器 http://127.0.0.1:8000/mcp
  2. 使用qwen2.5型号在前台启动连接到Ollama的MCP主机
  3. 退出时自动清理后台服务器(Ctrl+C)

检查MCP工具

要交互式检查和测试MCP工具,请在单独的终端上运行以下命令:

uv run python mcp_server.py
npx @modelcontextprotocol/inspector

这将在浏览器中打开一个交互式检查器,您可以在其中:

  • 查看所有可用工具
  • 具有不同参数的测试工具
  • 实时查看工具响应

致谢

该项目是作为 拥抱面部MCP课程特别感谢Hugging Face团队提供优质的教育资源。