GitHub Issues

@modelcontextprotocol/server-github MCP サーバーを使用して GitHub issue を管理します。

利用可能なツール

MCP ツール (読み取り操作)

ツール	目的
mcp__github__issue_read	issue の詳細、サブ issue、コメント、ラベルを読み取ります (メソッド: get, get_comments, get_sub_issues, get_labels)
mcp__github__list_issues	リポジトリの issue を状態、ラベル、日付でリストアップおよびフィルタリングします
mcp__github__search_issues	GitHub 検索構文を使用してリポジトリ全体の issue を検索します
mcp__github__projects_list	プロジェクト、プロジェクトフィールド、プロジェクト項目、ステータス更新をリストアップします
mcp__github__projects_get	プロジェクト、フィールド、項目、またはステータス更新の詳細を取得します
mcp__github__projects_write	プロジェクト項目を追加/更新/削除し、ステータス更新を作成します

CLI / REST API (書き込み操作)

MCP サーバーは現在、issue の作成、更新、またはコメント機能をサポートしていません。これらの操作には gh api を使用してください。

操作	コマンド
issue を作成	gh api repos/{owner}/{repo}/issues -X POST -f title=... -f body=...
issue を更新	gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f title=... -f state=...
コメントを追加	gh api repos/{owner}/{repo}/issues/{number}/comments -X POST -f body=...
issue をクローズ	gh api repos/{owner}/{repo}/issues/{number} -X PATCH -f state=closed
issue タイプを設定	create コールに -f type=Bug を含めます (REST API のみ、gh issue create CLI ではサポートされていません)

注: gh issue create は基本的な issue 作成に対応していますが、--type フラグをサポートしていません。issue タイプを設定する必要がある場合は gh api を使用してください。

ワークフロー

1. アクションを決定: 作成、更新、またはクエリか?
2. コンテキストを収集: 必要に応じてリポジトリ情報、既存ラベル、マイルストーンを取得
3. コンテンツを構造化: references/templates.md から適切なテンプレートを使用
4. 実行: 読み取りは MCP ツール、書き込みは gh api を使用
5. 確認: issue URL をユーザーに報告

Issue の作成

gh api を使用して issue を作成します。issue タイプを含むすべてのパラメータをサポートします。

gh api repos/{owner}/{repo}/issues \
  -X POST \
  -f title="Issue title" \
  -f body="Issue body in markdown" \
  -f type="Bug" \
  --jq '{number, html_url}'

オプションパラメータ

gh api コールに以下のフラグを追加できます:

-f type="Bug"                    # Issue タイプ (Bug, Feature, Task, Epic など)
-f labels[]="bug"                # ラベル (複数の場合は繰り返す)
-f assignees[]="username"        # 担当者 (複数の場合は繰り返す)
-f milestone=1                   # マイルストーン番号

Issue タイプは組織レベルのメタデータです。利用可能なタイプを確認するには、以下を使用します:

gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'

分類にはラベルより issue タイプを優先してください。 Organization に issue タイプが設定されている場合 (例: Bug, Feature, Task)、bug や enhancement などの同等のラベルを適用する代わりに type パラメータを使用します。Issue タイプは GitHub で issue を分類する規範的な方法です。Organization に issue タイプが設定されていない場合のみラベルにフォールバックしてください。

タイトルガイドライン

• 具体的で実行可能なものにする
• 72 文字以下に保つ
• issue タイプが設定されている場合、[Bug] のような冗長なプリフィックスを追加しない
• 例:
  • Login fails with SSO enabled (type=Bug の場合)
  • Add dark mode support (type=Feature の場合)
  • Add unit tests for auth module (type=Task の場合)

本文の構造

常に references/templates.md のテンプレートを使用します。Issue タイプに基づいて選択:

ユーザーリクエスト	テンプレート
バグ、エラー、機能しない、動作しない	バグレポート
機能、改善、追加、新規	機能リクエスト
タスク、チョア、リファクタ、更新	タスク

Issue の更新

PATCH で gh api を使用します:

gh api repos/{owner}/{repo}/issues/{number} \
  -X PATCH \
  -f state=closed \
  -f title="Updated title" \
  --jq '{number, html_url}'

変更したいフィールドのみを含めてください。利用可能なフィールド: title、body、state (open/closed)、labels、assignees、milestone。

例

例 1: バグレポート

ユーザー: "バグ issue を作成してください - SSO 使用時にログインページがクラッシュします"

アクション:

gh api repos/github/awesome-copilot/issues \
  -X POST \
  -f title="Login page crashes when using SSO" \
  -f type="Bug" \
  -f body="## Description
The login page crashes when users attempt to authenticate using SSO.

## Steps to Reproduce
1. Navigate to login page
2. Click 'Sign in with SSO'
3. Page crashes

## Expected Behavior
SSO authentication should complete and redirect to dashboard.

## Actual Behavior
Page becomes unresponsive and displays error." \
  --jq '{number, html_url}'

例 2: 機能リクエスト

ユーザー: "ダークモード機能リクエストを高優先度で作成してください"

アクション:

gh api repos/github/awesome-copilot/issues \
  -X POST \
  -f title="Add dark mode support" \
  -f type="Feature" \
  -f labels[]="high-priority" \
  -f body="## Summary
Add dark mode theme option for improved user experience and accessibility.

## Motivation
- Reduces eye strain in low-light environments
- Increasingly expected by users

## Proposed Solution
Implement theme toggle with system preference detection.

## Acceptance Criteria
- [ ] Toggle switch in settings
- [ ] Persists user preference
- [ ] Respects system preference by default" \
  --jq '{number, html_url}'

よく使われるラベル

該当する場合、これらの標準ラベルを使用します:

ラベル	用途
bug	何か問題がある
enhancement	新機能または改善
documentation	ドキュメント更新
good first issue	初心者向け
help wanted	追加の支援が必要
question	さらに情報が必要
wontfix	対応しない
duplicate	既に存在
high-priority	緊急の issue

ヒント

• issue を作成する前に必ずリポジトリコンテキストを確認してください
• 推測するのではなく、欠落している重要な情報を尋ねてください
• 既知の関連 issue をリンクします: Related to #123
• 更新の場合、現在の issue を取得して変更されていないフィールドを保持してください

拡張機能

以下の機能には、基本的な MCP ツール以上の REST または GraphQL API が必要です。各機能は、エージェントが必要な知識のみをロードできるよう、独自のリファレンスファイルで文書化されています。

機能	使用時	リファレンス
高度な検索	ブール論理、日付範囲、クロスリポ検索、issue フィールドフィルター (field.name:value) を使用した複雑なクエリ	references/search.md
サブ issue と親 issue	作業を階層的なタスクに分割	references/sub-issues.md
Issue 依存関係	ブロック / ブロック関係のトラッキング	references/dependencies.md
Issue タイプ (高度)	MCP list_issue_types / type パラメータ以外の GraphQL 操作	references/issue-types.md
Projects V2	プロジェクトボード、進捗レポート、フィールド管理	references/projects.md
Issue フィールド	カスタムメタデータ: 日付、優先度、テキスト、数値 (プライベートプレビュー)	references/issue-fields.md
Issue 内の画像	CLI 経由で issue 本文とコメント内に画像を埋め込む	references/images.md