Secure Github Ops

🚀 安全的GitHub操作MCP服務器

由Aaron Murillo創建

這是一個MCP服務器，可讓GitHub自動化操作真正變得安全。每個寫入操作在執行前都需要經過審批，這樣你就再也不用擔心在你去喝咖啡的時候，失控的腳本會創建100個問題。

🚀 快速開始

你需要Node 18+和一個GitHub令牌。

cd secure-github-ops
npm install
cp .env.example .env

打開 .env 文件並填寫以下內容：

GITHUB_TOKEN=ghp_your_token_here
ADMIN_API_KEYS=some-secret-admin-key
OPERATOR_API_KEYS=some-secret-operator-key

然後運行：

npm run build
npm start

若要開啟帶有熱重載的開發模式：

npm run dev

✨ 主要特性

• 安全審批機制：所有寫入操作需審批後執行，避免失控腳本帶來的風險。
• 雙角色管理：操作員可發起操作請求，管理員可審批、拒絕並查看待處理操作。
• 日誌記錄：所有操作都有記錄，提供完整的審計跟蹤。

📦 安裝指南

本地安裝

按照上述快速開始部分的步驟操作即可完成本地安裝。

Docker安裝

docker build -t secure-github-ops .
docker run -e GITHUB_TOKEN=... -e ADMIN_API_KEYS=... secure-github-ops

💻 使用示例

與Claude Desktop配合使用

在你的Claude Desktop配置中添加以下內容：

{
  "mcpServers": {
    "secure-github-ops": {
      "command": "node",
      "args": ["/path/to/secure-github-ops/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token",
        "ADMIN_API_KEYS": "your-admin-key",
        "OPERATOR_API_KEYS": "your-operator-key"
      }
    }
  }
}

操作示例

操作員創建問題請求

// 操作員發起請求
{
  "tool": "github.issues.create",
  "arguments": {
    "_authToken": "operator-key",
    "owner": "myorg",
    "repo": "myrepo",
    "title": "Fix the login bug"
  }
}
// 返回帶有ID的待處理操作

管理員查看待處理操作

{
  "tool": "admin.list_pending_actions",
  "arguments": { "_authToken": "admin-key" }
}
// 顯示待處理的問題請求

管理員批准操作

{
  "tool": "admin.approve_action",
  "arguments": {
    "_authToken": "admin-key",
    "actionId": "the-uuid-from-before"
  }
}
// 此時問題才會被創建

📚 詳細文檔

可用工具

操作員和管理員均可使用

• github.issues.create - 請求創建一個問題
• github.pr.open - 請求打開一個拉取請求
• github.comment.add - 請求添加一條評論

僅管理員可用

• admin.approve_action - 批准並執行一個待處理操作
• admin.deny_action - 拒絕一個待處理操作
• admin.list_pending_actions - 查看待處理的操作

配置選項

• GITHUB_TOKEN（必需） - 具有倉庫訪問權限的GitHub個人訪問令牌。
• ADMIN_API_KEYS（必需） - 以逗號分隔的管理員密鑰。
• OPERATOR_API_KEYS（可選） - 以逗號分隔的操作員密鑰。
• ALLOWED_REPOS（可選） - 將操作限制在特定的倉庫，格式如 owner/repo1,owner/repo2。
• LOG_LEVEL（可選） - 日誌級別，可選值為 debug、info、warn、error。

關於STDIO傳輸

本服務器使用STDIO進行通信，即通過標準輸入/輸出進行交互。所有日誌信息會輸出到標準錯誤輸出，以免干擾協議。如果你奇怪為什麼代碼中沒有 console.log，原因就在於此。

如果你希望使用HTTP傳輸，這已列入開發計劃。核心代碼保持不變，只需更換傳輸方式即可。

🔧 技術細節

測試

npm test

共有26個測試用例，涵蓋身份驗證、配置和待處理存儲等方面。

未來規劃

• 最終會添加HTTP傳輸方式，以便將其作為服務進行託管。
• 考慮為待處理操作添加持久化存儲（目前這些操作存儲在內存中）。