Github Review MCP

🚀 GitHub MCP 服務器

這是一個最小模型上下文協議（MCP）服務器，為 AI 助手提供聚焦於 GitHub 的工具。

🚀 快速開始

本地部署

# 1. 克隆倉庫並安裝依賴
git clone <repo-url>
cd github-review-mcp
pnpm install

# 2. 添加憑證
echo "GITHUB_TOKEN=ghp_your_token_here" > .env

# 3. 啟動服務器
pnpm start

服務器將監聽 MCP 客戶端指定的端口（默認端口為 3000）。

從 MCP 客戶端使用

Cursor IDE

將以下內容添加到 設置 → 擴展 → MCP（或者你的 mcp-servers.json 文件中）：

{
  "mcpServers": {
    "github-review-server": {
      "command": "node",
      "args": ["/absolute/path/github-review-mcp/src/index.js"],
      "env": { "GITHUB_TOKEN": "ghp_your_token_here" }
    }
  }
}

通用 MCP 客戶端

將客戶端指向 node /absolute/path/github-review-mcp/src/index.js，並在環境變量中傳遞 GITHUB_TOKEN。

Docker 部署（託管）

項目中包含了一個與託管鏡像對應的 Dockerfile。

# 構建鏡像
docker build -t gh-mcp .

# 運行容器
docker run -e GITHUB_TOKEN=ghp_your_token_here -p 3000:3000 gh-mcp

使用 http://localhost:3000（或映射的端口）作為命令，將容器連接到你的 MCP 客戶端。

🔧 環境變量

🛠️ 可用工具

核心的拉取請求實用工具以及高級分析模塊：

• get_review_prompts ⭐（請先調用此工具！）
• get_pr_details
• get_pr_files
• get_pr_commits
• get_file_content
• post_pr_review
• get_repo_info

高級分析（🚀）：

• analyze_code_quality
• analyze_diff_impact
• detect_security_issues
• detect_code_patterns
• analyze_dependencies
• analyze_test_coverage
• generate_suggestions

如需詳細的使用示例，請查看原始 README 歷史記錄或 src/tools/ 中的內聯 JSDoc。