Github Security MCP Server

🚀 GitHub ツールの MCP サーバー

このリポジトリには、GitHub とのやり取りを可能にするモデルコンテキストプロトコル（MCP）サーバーの実装が含まれています。このサーバーは TypeScript と MCP SDK を使用して構築されており、Visual Studio Code 内で GitHub Copilot などの MCP クライアントと統合できます。

✨ 主な機能

現在、このサーバーが提供するツールは以下の通りです。

• GitHub ユーザー情報：ユーザー名を指定して GitHub ユーザーの詳細情報を取得します。
• セキュリティ問題の作成：GitHub リポジトリ内に適切な形式とラベル付きのセキュリティ問題を作成します。
• セキュリティ問題の一覧表示：GitHub リポジトリ内のすべてのセキュリティ関連の問題を一覧表示します。
• セキュリティ状態レポート：Dependabot、コードスキャン、機密情報スキャンを含む包括的なセキュリティアラートを取得します。
• ブランチ管理：GitHub リポジトリのブランチを一覧表示し、新規作成します。
• プルリクエスト管理：
  • 2 つのブランチ間でプルリクエストを作成します。
  • 特定のリポジトリのすべてのプルリクエストを一覧表示し、番号、タイトル、説明などの基本情報を表示します。
  • 特定のプルリクエストの詳細情報（差分やコメントを含む）を取得します。

📦 インストール

前提条件

• Node.js
• npm（Node.js に含まれています）
• インストール済みで認証済みの GitHub CLI (gh)

認証

この MCP サーバーは、GitHub CLI を使用して現在認証されているユーザーのトークンを取得し、認証に使用します。

ローカルでの実行

サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

npm start

開発時には、ファイルが変更されるたびに自動的に再構築するには、以下のコマンドを使用します。

npm run dev

サーバーのデバッグと検査には、以下のコマンドを使用します。

npm run inspect

VS Code での統合

最新リリースバージョンの実行

最新リリースバージョンを使用するには、新しいツールを追加し、Command (stdio) を選択して、コマンド npx @rickardhf/github-security-mcp-server を使用します。

プロジェクトの mcp.json 構成ファイルのみを変更する場合は、以下の構成を使用できます。

{
    "servers": {
        "my-local-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "@rickardhf/github-security-mcp-server"
            ]
        }
    },
    ...
}

ローカルバージョンの実行

プロジェクト内のローカルバージョンを使用するには、プロジェクトのビルドファイルを実行します。以下の構成を mcp.json ファイルに追加できます。これはグローバルに、または特定のワークスペースに対して行うことができます。

{
    "servers": {
        "my-local-mcp-server": {
            "type": "stdio",
            "command": "node",
            "args": [
                "c:\\repos\\private\\mcptest\\dist\\index.js"
            ]
        }
    }
}

ローカルバージョンを実行するには、以下のコマンドを使用します。

npm run build && npm start

プロジェクト構造

• src/index.ts：メインエントリポイントとサーバーの設定
• src/common/：共有ツールと型定義
  • utils.ts：共有ユーティリティ関数（GitHub トークンの取得など）
  • types.ts：TypeScript の型定義
• src/operations/：ツールの実装
  • process.ts：ツールの登録とマッピング
  • security.ts：セキュリティ状態レポート機能
  • api/：GitHub API 操作
    • branch.ts：ブランチ管理操作
    • issues.ts：セキュリティ問題操作
    • pull-requests.ts：プルリクエスト操作
    • repo.ts：リポジトリ操作