gh-mcp

gh（GitHub CLI）の body を持つ操作だけを薄くラップする stdio MCP サーバ。

なぜ

issue / PR の長文 Markdown body をシェル経由で gh に渡すと、PowerShell の here-string（@'...'@）・stop-parsing トークン（--%）・クォートエスケープで 繰り返し事故る。このサーバは body を JSON 引数で受け取り、一時ファイルに書いて gh ... --body-file <tmp> を shell=False で実行する。シェルが body 文字列を 一切見ないので、事故が構造的に消える。

公式 GitHub MCP（HTTP）が接続不安定なための代替でもある。認証は既存の gh auth ログインをそのまま使う（PAT 不要）。

Related MCP server: GitHub CLI MCP Server

提供ツール（事故が多い body 持ち系のみ）

読み取り系（gh issue view / gh pr list 等）は body を持たず事故らないため ラップしない。従来どおり gh を直接呼ぶこと。

返り値: { ok, url, stdout, stderr, exit_code }。url は gh が出力する 作成済み issue/PR の URL（stdout の先頭 http 行）。

登録

uv で依存（fastmcp）を隔離実行する。グローバル Python を汚さない。

claude mcp add gh-mcp -- uv run --project "C:\Users\ynaga\.claude\mcp\gh-mcp" python server.py

登録後、claude mcp list で接続を確認できる。

動作確認（手動）

uv run --project "C:\Users\ynaga\.claude\mcp\gh-mcp" python -c "import server; print([t for t in dir(server) if t.startswith('gh_')])"

前提

• gh 2.x がインストール済みで gh auth status が通っていること。

• gh は PATH から解決。見つからなければ C:\Program Files\GitHub CLI\gh.exe に フォールバックする（server.py の _resolve_gh）。