MCP Test

🚀 PR 審查者設置指南

本指南將為你提供設置 PR 審查者項目的詳細步驟，其中涵蓋了與 GitHub 和 Notion 的集成方法，助你順利完成項目搭建。

🚀 快速開始

本項目的設置需要一些先決條件，並按照特定步驟進行操作。下面將詳細介紹每個步驟。

📦 安裝指南

先決條件

• curl（適用於 MacOS/Linux）
• 系統上安裝了 Python 3.x

第一步：安裝 uv

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

🔁 安裝完成後，請重新啟動終端以確保 uv 命令可用。

第二步：創建和設置項目

MacOS/Linux:

# 創建新目錄用於項目
uv init pr_reviewer
cd pr_reviewer

# 創建並激活虛擬環境
uv venv
source .venv/bin/activate

# 安裝核心依賴項
uv add "mcp[cli]" requests python-dotenv notion-client

第三步：創建 requirements.txt 並從中安裝

創建一個名為 requirements.txt 的文件，並添加以下內容：

# PR 分析器的核心依賴項
requests>=2.31.0          # 用於GitHub API調用
python-dotenv>=1.0.0      # 用於環境變量
mcp[cli]>=1.4.0           # 用於MCP服務器功能
notion-client>=2.3.0      # 用於Notion集成

安裝包：

uv pip install -r requirements.txt
pip install -r requirements.txt

第四步：設置環境變量

在根目錄中創建一個 .env 文件，並添加以下內容：

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHub 令牌：

1. 轉到 GitHub → 設置 → 開發者設置 → 個人訪問令牌。
2. 點擊 “生成新的令牌（經典）”。
3. 啟用以下範圍：
   • read:org
   • read:repo_hook
   • repo
4. 將令牌複製到 .env 文件中作為 GITHUB_TOKEN。

Notion 集成：

1. 轉到 Notion 集成。
2. 點擊 “新建集成”，並設置類型為 內部。
3. 將其添加到你的工作區中。
4. 複製 內部集成密鑰 作為 NOTION_API_KEY。
5. 複製 集成 URL 末尾的 UUID 作為 NOTION_PAGE_ID。

第五步：創建主腳本

創建一個空腳本文件用於服務器邏輯：

touch pr_reviewer

在該文件中添加你的應用程序邏輯。

第六步：運行應用程序

要運行項目，請確保環境已激活且 .env 已配置：

python pr_reviewer.py