Github Dependabot MCP server

Github Dependabot MCP サーバー

指定したリポジトリの Github Dependabot アラートを取得します。

要件

• uv：高速な Python パッケージインストーラーおよびリゾルバーです。スクリプトの実行と依存関係の管理に使用します。
• Github Personal Access Token：Github API での認証に必要です。必要な権限（例：repo、security_events）が付与されていることを確認してください。

セットアップ

1. uv をインストールする： お使いの OS に対応した公式のインストール手順に従ってください。

   • macOS / Linux：
     • Homebrew を使用する（macOS）：

       brew install uv
       

     • または curl を使用する：

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

   • Windows（PowerShell）：

     irm https://astral.sh/uv/install.ps1 | iex
     

   • その他の方法：uv のドキュメントを参照してください。

2. リポジトリをクローンする：

   git clone [email protected]:avarant/github-dependabot-mcp-server.git
   cd github-dependabot-mcp-server
   

3. Github 認証を設定する：

   まだお持ちでない場合は、まず Github Personal Access Token（PAT）を生成する必要があります。

   1. Github の Settings -> Developer settings -> Personal access tokens -> Tokens (classic) に移動します。
   2. 「Generate new token」（または「Generate new token (classic)」）をクリックします。
   3. トークンにわかりやすい名前（例：「MCP Dependabot Server」）を付けます。
   4. 有効期限を設定します。
   5. 必要なスコープを選択します。
      • repo（プライベートリポジトリの完全な制御）— リポジトリデータへのアクセスに必要です。
      • security_events（セキュリティイベントの読み取り）— Dependabot アラートの読み取りに必要です。
   6. 「Generate token」をクリックし、生成されたトークンをすぐにコピーします。後から再表示することはできません。

   トークンを用意したら、このサーバーが Github API で認証するために使用します。トークンの指定方法は 2 通りあります。

   • オプション 1：macOS Keychain を使用する（macOS で推奨）： スクリプトは keyring ライブラリを使用して、macOS Keychain からトークンを自動的に読み取ろうとします。

     • コマンドラインから設定する場合： ターミナルで次のコマンドを実行し、<your token> を実際の Github トークンに置き換えます。

       # 仮想環境を使用している場合は、プロジェクトの仮想環境が有効になっていることを確認してください
       # 必要に応じて keyring をグローバルにインストールすることもできます：pip install keyring
       keyring set github_mcp_server personal_access_token
       # トークンを安全に入力するよう求められます。
       

       または、Python モジュールを使用します。

       python -m keyring set github_mcp_server personal_access_token
       

     • Keychain Access の UI から設定する場合：

       1. 「Keychain Access」を開きます（Applications -> Utilities）。
       2. login キーチェーンと Passwords カテゴリを選択します。
       3. + ボタンをクリックして、新しい項目を追加します。
       4. 次の情報を入力します。
          • キーチェーン項目名： personal_access_token
          • アカウント名： github_mcp_server
          • パスワード： Github トークンを貼り付けます。
       5. 「Add」をクリックします。

   • オプション 2：環境変数を使用する： Keychain にトークンが見つからない場合、スクリプトは代わりに GITHUB_PERSONAL_ACCESS_TOKEN 環境変数を使用します。この方法を使用すると、keyring が機能する場合、スクリプトは今後の利用に備えてトークンを Keychain に保存しようとします。

4. MCP 設定を更新する：

   グローバルの ~/.cursor/mcp.json を編集するか、プロジェクト内にローカルの .cursor/mcp.json ファイルを作成します。

   {
     "mcpServers": {
       "github": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "GITHUB_PERSONAL_ACCESS_TOKEN",
           "mcp/github"
         ],
         "env": {
           // Optional: Set if NOT using Keychain, or as a fallback.
           // "GITHUB_PERSONAL_ACCESS_TOKEN": "<your github token>"
         }
       },
       "github-dependabot": {
         "command": "uv",
         "args": [
           "--directory",
           "<absolute path to github-dependabot-mcp-server directory>",
           "run",
           "mcp",
           "run",
           "main.py"
         ],
         "env": {
           // Optional: Set if NOT using Keychain, or as a fallback.
           // "GITHUB_PERSONAL_ACCESS_TOKEN": "<your github token>"
         }
       }
     }
   }
   

   注: <absolute path to github-dependabot-mcp-server directory> を実際のパスに置き換えてください。

提供されるツール

この MCP サーバーは次のツールを提供します。

• get_dependabot_alerts(repo_owner: str, repo_name: str):
  • 指定したリポジトリの Dependabot アラートを取得します。
  • repo_owner: リポジトリの所有者（ユーザー名または組織名）。
  • repo_name: リポジトリ名。
  • Github API から取得したアラートオブジェクトのリストを返します。

使用例

プロンプトの例

Fetch all dependabot alerts for https://github.com/avarant/github-dependabot-mcp-server