Secure Github Ops

🚀 Secure GitHub Ops MCP Server

この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

✨ 主な機能

承認制の自動化

ほとんどの自動化ツールは即座に処理を実行しますが、このサーバーはそれを逆転させます。あなた（またはAI）がイシューを作成したり、PRを開いたり、コメントを追加したりすると、それらは保留キューに入ります。その後、管理者権限を持つユーザーがレビューして承認すると、初めてGitHubに反映されます。

2つの役割

• オペレーター：アクションをリクエストできます。
• 管理者：保留中のアクションを承認、拒否し、保留中のアクションを確認できます。

完全な監査トレイル

すべての操作がログに記録されるため、完全な監査トレイルを確認できます。

📦 インストール

前提条件

• Node 18以上
• GitHubトークン

手順

1. リポジトリをクローンし、ディレクトリに移動します。

cd secure-github-ops

2. 依存関係をインストールします。

npm install

3. 環境変数ファイルを作成します。

cp .env.example .env

4. .env ファイルを編集し、必要な情報を入力します。

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

5. アプリケーションをビルドして起動します。

npm run build
npm start

💻 使用例

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：PR作成リクエスト
• github.comment.add：コメント追加リクエスト

管理者専用

• admin.approve_action：保留中のアクションを承認して実行
• admin.deny_action：保留中のアクションを拒否
• admin.list_pending_actions：保留中のアクションを確認

設定オプション

• GITHUB_TOKEN（必須）：リポジトリアクセス権限を持つGitHub Personal Access Token
• ADMIN_API_KEYS（必須）：カンマ区切りの管理者キー
• OPERATOR_API_KEYS（オプション）：カンマ区切りのオペレーターキー
• ALLOWED_REPOS（オプション）：特定のリポジトリに制限する場合、owner/repo1,owner/repo2 の形式で指定
• LOG_LEVEL（オプション）：debug、info、warn、error から選択

STDIOトランスポートについて

このサーバーはSTDIOを使用しており、stdin/stdoutを介して通信します。すべてのログはstderrに出力されるため、プロトコルに影響を与えません。コンソールにログが表示されないのはこのためです。

HTTPトランスポートを使用する機能は今後のロードマップにあります。コアコードは変更せずに、トランスポートを切り替えることができます。

🔧 技術詳細

このサーバーはNode.jsで構築されており、STDIOを介して通信します。すべての操作はログに記録され、承認制によって安全な自動化を実現しています。

📄 ライセンス

原文書にライセンス情報は記載されていません。

テストの実行

npm test

認証、設定、保留中のアクションの保存に関する26のテストが含まれています。

Dockerを使用した実行

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

今後の予定

最終的にはHTTPトランスポートを追加し、このサーバーをサービスとしてホストできるようにする予定です。また、保留中のアクションを永続的に保存する機能も検討しています（現在はメモリ上に保存されています）。