MCP Starter

🚀 GitHub PR分析器與Notion集成

這是一個模型上下文協議（MCP）服務器，可獲取GitHub拉取請求的變更信息，並在Notion中創建分析摘要。

教程：請按照DataCamp的MCP教程進行逐步操作。

✨ 主要特性

• 🔍 獲取詳細的GitHub拉取請求信息，包括：
  • 文件變更（新增、刪除、修改）
  • 拉取請求元數據（標題、描述、作者、時間戳）
  • 每個變更文件的差異補丁
• 📝 在Notion中創建包含拉取請求分析的頁面
• 🔌 集成MCP服務器，實現工具的無縫使用

📦 安裝指南

前提條件

• Python 3.8 或更高版本
• GitHub個人訪問令牌
• Notion API密鑰和頁面ID

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd mcp-starter

2. 創建並激活Python虛擬環境：

# 創建虛擬環境
python -m venv venv

# 激活虛擬環境
# 在macOS/Linux上：
source venv/bin/activate

# 在Windows上：
# venv\Scripts\activate

3. 安裝依賴項：

pip install -r requirements.txt

4. 在項目根目錄下創建一個 .env 文件，並填入你的憑證信息：

GITHUB_TOKEN=your_github_token_here
NOTION_API_KEY=your_notion_api_key_here
NOTION_PAGE_ID=your_notion_page_id_here

獲取憑證信息

GitHub令牌：

1. 進入GitHub設置 → 開發者設置 → 個人訪問令牌
2. 生成一個具有 repo 權限的新令牌
3. 將令牌複製到你的 .env 文件中

Notion API密鑰：

1. 訪問https://www.notion.so/my-integrations
2. 創建一個新的集成，並複製內部集成令牌
3. 將你的Notion頁面共享給該集成

Notion頁面ID：

1. 在瀏覽器中打開你的Notion頁面
2. 從URL中複製頁面ID（最後一個 / 之後、? 之前的部分）

💻 使用示例

運行MCP服務器

首先，確保你的虛擬環境已激活：

# 在macOS/Linux上：
source venv/bin/activate

# 在Windows上：
# venv\Scripts\activate

然後運行服務器：

python pr_analyzer.py

服務器提供了兩個MCP工具：

1. fetch_pr

從GitHub獲取拉取請求信息。 參數：

• repo_owner (str)：倉庫所有者用戶名
• repo_name (str)：倉庫名稱
• pr_number (int)：拉取請求編號

返回值：

• 拉取請求元數據和詳細的文件變更信息

2. create_notion_page

創建一個包含分析內容的Notion頁面。 參數：

• title (str)：頁面標題
• content (str)：頁面內容

返回值：

• 成功或錯誤消息

直接使用（開發/測試）

你也可以直接使用 github_integration.py 模塊：

from github_integration import fetch_pr_changes

# 獲取拉取請求變更信息
pr_data = fetch_pr_changes('owner', 'repo', 123)
print(pr_data)

🔧 技術細節

項目結構

mcp-starter/
├── github_integration.py  # GitHub API集成
├── pr_analyzer.py         # MCP服務器實現
├── requirements.txt       # 項目依賴項
├── .env                   # 環境變量（不在git中）
└── README.md             # 本文件

依賴項

主要依賴項包括：

• mcp - 模型上下文協議服務器
• requests - GitHub API調用
• notion-client - Notion API集成
• python-dotenv - 環境變量管理
• pydantic - 數據驗證
• httpx - 異步HTTP客戶端

完整列表請參考 requirements.txt。

錯誤處理

該應用程序包含全面的錯誤處理機制：

• 捕獲並記錄API請求失敗信息
• 缺少憑證時觸發相應的錯誤消息
• 將堆棧跟蹤信息打印到標準錯誤輸出，以便調試

開發

若要貢獻代碼或進行修改：

1. 確保你的 .env 文件配置正確
2. 在運行MCP服務器之前，使用直接使用方法測試變更
3. 查看標準錯誤輸出以獲取調試信息

安全注意事項

⚠️ 重要提示

切勿將你的 .env 文件提交到版本控制中，因為它包含敏感憑證信息。

將以下內容添加到你的 .gitignore 文件中：

.env
__pycache__/
*.pyc

📄 許可證

本項目採用MIT許可證。

版權所有 (c) 2024

特此免費授予任何獲得本軟件及相關文檔文件（“軟件”）副本的人，允許其無限制地處理本軟件，包括但不限於使用、複製、修改、合併、發佈、分發、再許可和/或出售軟件副本的權利，並允許向其提供軟件的人這樣做，但須遵守以下條件：

上述版權聲明和本許可聲明應包含在所有副本或軟件的重要部分中。

軟件按“原樣”提供，不提供任何形式的明示或暗示保證，包括但不限於適銷性、特定用途適用性和不侵權的保證。在任何情況下，作者或版權持有人均不對因合同、侵權或其他方式引起的任何索賠、損害或其他責任負責，無論是在與軟件或軟件的使用或其他交易有關的任何行動中。

本項目根據Unlicense許可發佈到公共領域。

你可以自由使用、修改、分發和利用本軟件，用於任何目的，包括商業和非商業用途，無需任何限制或歸屬要求。

更多詳情，請參閱Unlicense。

作者

Kiet Tran (Leo Loves Coding)

支持

如有問題或疑問，請在倉庫中創建一個issue。