客製化 GitHub Issue 管理 MCP 伺服器 - n8n 工作流程

• 希望將 AI 代理人與 Issue 追蹤整合的開發人員和 DevOps 團隊。


• 尋求對 AI 存取其 GitHub 儲存庫有安全且精細化控制的使用者。


• 想利用 n8n 工作流邏輯建置客製化 AI 工具的 n8n 使用者。

這個專門的 n8n 工作流展示了如何建構您自己的客製化 GitHub MCP 伺服器。此 n8n 範本讓您不必依賴通用伺服器，而是能為您的 AI 代理人（例如 Claude 或其他 MCP 客戶端）定義精確的存取權限和功能。其核心價值在於提升了安全性與客製化程度，確保代理人只在指定的 GitHub 儲存庫上執行特定、受保護的操作。透過使用 n8n 來管理邏輯，您可以輕鬆地將此基礎擴展到包含與 Pull Request 的互動、生成報表，或客製化輸出結構。此方法利用了 n8n 節點生態系的強大功能，以建立穩健的 AI 驅動解決方案。

整個自動化流程是由一個專門的 n8n 觸發器啟動的，即 GitHub MCP 伺服器節點。這個 n8n 觸發器會等待來自相容 MCP 客戶端（例如 AI 代理人）的指令。
定義了三個專用的工具工作流節點，使代理人可以呼叫特定的 GitHub 操作：「取得最新 Issues」、「取得 Issue 留言」和「新增 Issue 留言」。

1. 工具呼叫 (Tool Invocation): 當 AI 代理人呼叫其中一個工具時，該指令會執行「被另一個工作流執行時 (When Executed by Another Workflow)」的 n8n 節點，並傳遞如 operation、repo 和 issueNumber 等參數。


2. 路由分配 (Routing): 一個名為「操作 (Operation)」的切換 (Switch) n8n 節點會檢查 operation 參數，以將流程路由到正確的任務分支。


3. 任務執行 (Task Execution):

此結構確保了乾淨、模組化的執行，讓 n8n 工作流能安全地處理所有與底層 GitHub API 的互動。

若要安裝這個穩健的 n8n 工作流，請遵循以下步驟：

1. 匯入 n8n 工作流： 複製提供的 JSON 資料，然後前往您的 n8n 實例。選擇「工作流 (Workflows)」>「新增 (New)」>「從 JSON 匯入 (Import from JSON)」，然後貼上程式碼。


2. 設定 GitHub 憑證： 這個 n8n 範本需要有效的 GitHub API 憑證。您必須設定一個憑證資源，供 GitHub n8n 節點用來向 API 進行驗證。請確保此帳號對目標儲存庫具有必要的讀取和寫入權限（例如預設配置中使用的 'n8n-io/n8n'）。


3. 設定 MCP 伺服器 n8n 觸發器： 啟用「GitHub MCP 伺服器 (Github MCP Server)」n8n 觸發器。在轉移到正式環境前，強烈建議（如便利貼中所述）為此 n8n 觸發器啟用驗證以確保安全。


4. 連接您的客戶端： 使用 MCP 伺服器 n8n 觸發器產生的端點 URL，連接您偏好的 MCP 客戶端（例如 Claude Desktop），並開始測試查詢，例如：「你可以幫我取得關於 MCP 的最新 Issue 嗎？」。

GitHub MCP 伺服器 (n8n 觸發器)： 整個 n8n 工作流的起點。它作為一個 API 端點，等待 AI 代理人透過模型上下文協議 (Model Context Protocol) 傳送結構化指令。
工具工作流 (Tool Workflow) (n8n 節點)： 配置了三個獨立的工具工作流節點（「取得最新 Issues」、「取得 Issue 留言」和「新增 Issue 留言」）。這些節點將複雜的 GitHub 操作封裝成簡單、描述性的工具，供 AI 代理人智慧地呼叫。它們定義了所需的輸入（例如 issueNumber、text）。
被另一個工作流執行時 (When Executed by Another Workflow) (n8n 節點)： 當工具工作流呼叫回同一個 n8n 工作流實例時，此節點作為內部進入點，接收代理人傳遞的輸入。
操作 (Operation) (切換 Switch n8n 節點)： 這是必要的流程控制。此 n8n 節點會根據 operation 參數（getLatestIssues、getIssueComments、addIssueComment）動態路由傳入的請求到正確的後續 GitHub 操作分支。
GitHub (n8n 節點)： 在各分支中用於核心操作：「取得多個 Issues」（用於尋找最新 Issues）、「取得單一 Issue」（用於開始擷取留言）和「建立留言」（用於回覆 Issues）。配置使用表達式從傳入的資料中擷取儲存庫和 Issue 編號。
HTTP 請求 (HTTP Request) (n8n 節點)： 專門用於 getIssueComments 流程中，使用初步 Issue 負載資料中提供的專用 URL 來擷取留言，這需要驗證過的存取權限。

• 設定 (Set) (n8n 節點)： 被廣泛使用（例如「簡化 Issues」、「簡化留言」），用於清理和結構化 GitHub n8n 節點返回的資料，確保最終輸出對 AI 代理人來說是簡潔且相關的。