記事一覧
MCPトークン

GitHub MCPサーバーのトークン消費をツールセット別に実測:92ツールの内訳と、toolsets・読み取り専用・X-MCP-Toolsで92%減らす設定【MCP Token・2026年版】

GitHub MCPサーバーが毎リクエスト何トークン使うかを、92ツールのスナップショットから実測。ツールセット別の内訳、重いツール、7通りの設定のClaude Sonnet 5.5での費用、toolsets・読み取り専用・X-MCP-Toolsの設定方法、Claude Codeのツール検索との関係、fieldsやCSVで結果を減らす方法、計測スクリプトまで。

最終更新:2026年11月12日 / 対象:GitHub MCP Server(main ブランチ、ツールのスナップショットは2026年11月12日に取得)、リモートサーバー api.githubcopilot.com/mcp、Claude Codeのツール検索、Claude Sonnet 5.5の料金、o200k_baseトークナイザー(gpt-tokenizer 4.1.2)

GitHub MCP Serverは、多くの開発者が最初に入れるMCPサーバーで、同時に最も大きなサーバーの1つです。ローカル版だけで22のツールセットに92個のツールがあります。このサーバーがどれだけトークンを消費するかは、ほぼ設定で決まります。全ツールセットを有効にすると1リクエストあたり22,524トークン、必要な5ツールだけに絞ると1,726トークンでした。この記事では、全ツールの定義を実際にトークン化してツールセット別の内訳を出し、消費を減らす設定(ツールセット、読み取り専用モード、X-MCP-Tools、fields)を具体的に紹介します。

この記事の「トークン」はLLMのトークン(コンテキストと課金)のことで、GitHubの個人用アクセストークンやOAuthトークンのことではありません。

結論(30秒で読める要約)

  • 何も設定しないと、1リクエストあたり約10,600トークン。 既定では context・repos・issues・pull_requests・users の5ツールセットが有効になり、45ツールで10,618トークンです(o200k_baseで計測)。全ツールセットでは92ツール・22,524トークンになります。
  • 既定の消費の95%は3つのツールセット。 repos(3,975)、issues(3,139)、pull_requests(2,977)です。既定外では governance(2,580)と projects(2,512)が重く、projects_write は1ツールで1,567トークンあります。
  • 読み取り専用モードで既定の40%を削減。 読み取り系の27ツール(6,318トークン)だけが残ります。context,issues,pull_requests だけに絞って読み取り専用にすると、13ツール・3,227トークンです。
  • 一番効くのはツール名の指定。 リモートの X-MCP-Tools、ローカルの --tools で5ツールだけにすると1,726トークンで、全ツールセットの約13分の1です。Claude Sonnet 5.5で20リクエストの会話を試算すると、キャッシュなしで全ツールセットは0.901ドル、5ツールは0.069ドルでした。
  • 重いのは説明文ではなくスキーマ。 説明文は22,524トークンのうち2,391トークン(約11%)だけです。文章を削るより、ツールを減らすほうが効きます。
  • ツール結果にも削る手段がある。 8つのツールが fields 引数に対応し、search_repositories は既定で最小限の情報を返し、Insidersモードでは list_* の結果がCSVになります。

目次

  1. GitHub MCPサーバーのトークン消費は何で決まるか
  2. 実測:ツールセット別のトークン数
  3. 特に重いツール
  4. 設定別のトークン数と費用の比較
  5. ツールセット・ツール・読み取り専用モードの設定方法
  6. Claude Codeのツール検索との関係
  7. ツール結果のトークンを減らす:fields・minimal_output・CSV
  8. 自分の設定を計測するスクリプト
  9. チェックリスト
  10. よくあるハマりどころ
  11. NodeFlareならこう解決できる
  12. よくある質問

1. GitHub MCPサーバーのトークン消費は何で決まるか

GitHub MCPサーバーのトークン消費とは、GitHub MCP Serverのツール定義とツール結果が、LLMのコンテキストと料金に占める分のことです。ツール定義は、クライアントが最初から読み込む場合は毎リクエストの入力になります。ツール結果は、返ってきた後の毎リクエストで入力になります。

このサーバーは、一般的なMCPサーバーより調整できる項目が多いのが特徴です。READMEとサーバー設定ガイドの内容を表にまとめます。

設定 リモートサーバー ローカルサーバー トークンへの影響
ツールセット X-MCP-Toolsets ヘッダー、または /x/{toolset} のURL --toolsets / GITHUB_TOOLSETS 指定したツール群だけを読み込む
個別のツール X-MCP-Tools ヘッダー --tools / GITHUB_TOOLS 指定したツールを追加する(単独でもツールセットとの併用でも可)
ツールの除外 X-MCP-Exclude-Tools ヘッダー --exclude-tools / GITHUB_EXCLUDE_TOOLS 指定したツールを外す。ツールセットや個別指定より優先される
読み取り専用 X-MCP-Readonly ヘッダー、または /readonly のURL --read-only / GITHUB_READ_ONLY 書き込み系ツールを、明示的に指定されていても外す
Insiders X-MCP-Insiders ヘッダー、または /insiders のURL --insiders / GITHUB_INSIDERS 実験的なツールの追加、list_* のCSV出力
スコープによる絞り込み 常に有効 常に有効 クラシックPAT(ghp_ で始まるもの)では、権限のないツールが一覧から消える。それ以外のトークンでは全ツールが表示される

何も指定しないと、既定のツールセット(context・repos・issues・pull_requests・users)が使われます。GitHubの設定ガイドでも、ツールを個別に指定する方法は「必要なものが分かっていて、コンテキストの使用量を最適化したい人」向けと書かれています。

2. 実測:ツールセット別のトークン数

repos・issues・pull_requests はそれぞれ3,000〜4,000トークン、それ以外のツールセットはほとんどが1,000トークン未満でした。

計測方法。 リポジトリの pkg/github/__toolsnaps__/ には、全ツールの定義がJSONのスナップショットとして保存されています。main ブランチのREADME(2026年11月12日時点)からローカル版22ツールセットのツール一覧を取り、92ツール分のスナップショットをすべて取得しました。各ツールについて、クライアントがモデルに送る {name, description, input_schema} をo200k_baseでトークン化しています。Claudeのトークナイザーでは数が変わるので(8章)、相対的な大きさとして見てください。get_label は issues と labels の両方に入っているので、合計では1回だけ数えています。

ツールセット ツール数 うち読み取り系 トークン(全ツール) トークン(読み取り系のみ) 既定で有効?
repos 20 13 3,975 2,894 はい
issues 10 6 3,139 1,596 はい
pull_requests 10 3 2,977 1,301 はい
governance 4 2 2,580 1,031 いいえ
projects 3 2 2,512 945 いいえ
actions 4 3 1,271 1,024 いいえ
discussions 5 4 896 526 いいえ
notifications 6 2 824 432 いいえ
security_advisories 4 4 674 674 いいえ
labels 3 2 460 241 いいえ
copilot_issue_intents 1 0 396 0 いいえ
gists 4 2 369 178 いいえ
context 4 4 330 330 はい
code_security 2 2 323 323 いいえ
copilot 2 0 316 0 いいえ
secret_protection 2 2 313 313 いいえ
stargazers 3 1 313 175 いいえ
dependabot 2 2 276 276 いいえ
users 1 1 197 197 はい
orgs 1 1 192 192 いいえ
git 1 1 177 177 いいえ
code_quality 1 1 90 90 いいえ

「読み取り系」は、スナップショットに readOnlyHint: true があるツールです。1ツールあたりの平均は245トークンでした。リモートサーバーにはこのほかに copilot_spaces と github_support_docs_search のツールセット、create_pull_request_with_copilot ツールがありますが、今回の計測には含めていません。

削り方を考えるうえで重要な発見が2つあります。

  • 説明文はコストの約11%しかない。 92ツールの説明文は合計2,391トークンで、残りは入力スキーマ(引数名、型、enum、引数ごとの説明)です。500文字を超える説明文は pull_request_review_write(1,115文字)、list_notifications(557文字)、create_or_update_file(532文字)の3つだけでした。
  • 出力スキーマは大きいが、通常はモデルへの入力にならない。 84ツールが outputSchema も持っていて、その合計は32,485トークンと、入力側の定義全体より大きくなります。スナップショット全体では76,370トークンです。ただしClaude APIのツール形式は name・description・input_schema の3つだけなので、MCPツールをClaude向けに変換するクライアントは outputSchema をツール定義として送りません。

3. 特に重いツール

上位10ツールで7,303トークンと、全体の約3分の1を占めます。いくつかは、複数の操作を1つにまとめた「メソッド切り替え型」のツールで、スキーマに多くの操作の説明が入っています。

ツール ツールセット トークン 読み取り系
projects_write projects 1,567 いいえ
custom_properties_write governance 819 いいえ
issue_write issues 793 いいえ
repository_ruleset_read governance 783 はい
create_repository_ruleset governance 730 いいえ
actions_list actions 578 はい
pull_request_read pull_requests 546 はい
list_issues issues 535 はい
projects_list projects 489 はい
pull_request_review_write pull_requests 463 いいえ

逆に小さいのは get_gist(52)、get_me(54)、get_teams(62)、get_global_security_advisory(63)です。プロジェクトを読むだけのエージェントなら、/x/projects/readonly にするだけで projects_write が外れ、それだけで1リクエストあたり1,567トークン減ります。

4. 設定別のトークン数と費用の比較

全ツールセットから5ツールの個別指定に変えると、ツール定義のトークンは1リクエストあたり22,524から1,726へ、92%減りました。

前提。 ツール定義のトークンだけを数えます(2章のo200k_baseの値)。1回の会話は20リクエスト。料金はAnthropicの料金ページのClaude Sonnet 5.5の値で、入力が100万トークンあたり2ドル、5分キャッシュの書き込みが2.50ドル、キャッシュヒットが0.10ドルです。「キャッシュあり」は、定義を1回書き込み、残り19リクエストはキャッシュから読む場合です。メッセージ、ツール結果、Claudeのツール利用システムプロンプトはどの設定でも同じなので除いています。

設定 ツール数 1リクエストのトークン 200Kコンテキストに占める割合 1会話(キャッシュなし) 1会話(キャッシュあり)
A. 全ツールセット(/x/all) 92 22,524 11.3% $0.901 $0.099
B. 全ツールセット+読み取り専用(/x/all/readonly) 57 12,839 6.4% $0.514 $0.057
C. 既定(設定なし) 45 10,618 5.3% $0.425 $0.047
D. 既定+読み取り専用(/readonly) 27 6,318 3.2% $0.253 $0.028
E. context,issues,pull_requests 24 6,446 3.2% $0.258 $0.028
F. E+読み取り専用 13 3,227 1.6% $0.129 $0.014
G. 5ツールを個別指定 5 1,726 0.9% $0.069 $0.008

Gは get_me・issue_read・list_issues・pull_request_read・get_file_contents の5つです(54+321+535+546+270トークン)。

1行を手で検算(C): 10,618 × 20 = 212,360トークン。212,360 × 2ドル ÷ 1,000,000 = 0.425ドル。キャッシュありの場合は、書き込みが 10,618 × 2.50ドル/100万 = 0.0265ドル、ヒットが 19 × 10,618 × 0.10ドル/100万 = 0.0202ドルで、合計0.047ドルです。

読み取り方:

  • 1会話では小さく見えても、チームでは小さくない。 1日1,000会話なら、キャッシュなしでAは901ドル、Gは69ドルです(ツール定義だけで)。
  • キャッシュでどの設定も約89%下がる。 ただしコンテキストの空きは増えませんし、ツール一覧が1バイトも変わらない間しか効きません。説明文を1か所書き換えて再デプロイしただけでも崩れます。
  • 読み取り専用が一番安全で手軽な初期設定。 Dは既定の読み取り系ツールをすべて残したまま、Cより40%少なくなります。マージ、プッシュ、削除といったツールも手の届かないところに置けます。

5. ツールセット・ツール・読み取り専用モードの設定方法

ツールセット1つで足りるならURL、複数ならヘッダー、使うツールが決まっているなら X-MCP-Tools を使います。

リモートサーバー、ツールセット1つ、読み取り専用(VS Codeの mcp.json 形式。ほかのクライアントでもURLは同じです):

{
  "servers": {
    "github-issues": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/x/issues/readonly"
    }
  }
}

リモートサーバー、複数のツールセットやツールの個別指定。 /x/{toolset} のURLには1つのツールセットしか書けないので、ヘッダーを使います。

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "X-MCP-Toolsets": "context,issues,pull_requests",
        "X-MCP-Readonly": "true"
      }
    }
  }
}

表のGにするなら、ツールセットのヘッダーを "X-MCP-Tools": "get_me,issue_read,list_issues,pull_request_read,get_file_contents" に置き換えます。

ローカルサーバー(Docker):

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN \
  -e GITHUB_TOOLSETS="context,issues,pull_requests" \
  -e GITHUB_READ_ONLY=1 \
  ghcr.io/github/github-mcp-server

GitHubの設定ガイドにある優先順位は次のとおりです。読み取り専用は他のどの設定よりも優先されます。除外したツールは、ツールセットや個別指定より優先されます。--tools は --toolsets に追加される形で、--toolsets repos,issues --tools get_gist なら2つのツールセットに get_gist が加わります。GITHUB_TOOLSETS と --toolsets の両方があると、環境変数が優先されます。

6. Claude Codeのツール検索との関係

Claude Codeではツール検索が既定で有効なので、GitHubサーバーの定義が最初から全部読み込まれるわけではありません。それでも設定は効いてきます。Claude CodeのMCPドキュメントには「ツール検索は既定で有効で、MCPツールは遅延され、必要に応じて見つけられる」とあります。

ツール検索が有効でもトークンがかかる場面:

  • 読み込まれたツール。 モデルが見つけて読み込んだツールは、完全な定義としてコンテキストに入ります。projects_write を読み込むタスクは、その1,567トークンを払います。
  • 検索対象が大きい。 92ツールあると、issue_read・list_issues・search_issues のような似たツールが増え、不要なツールを読み込む機会も増えます。
  • ENABLE_TOOL_SEARCH=auto のとき。 このモードでは、ツール定義の合計がコンテキストウィンドウの10%未満なら最初から読み込まれます。200Kトークンのウィンドウなら、C(5.3%)は最初から読み込まれ、A(11.3%)は遅延されます。つまり、ツールセットを絞ると「遅延」から「常に読み込み」へ切り替わることがあります。100万トークンのウィンドウでは、どちらも10%未満なので最初から読み込まれます。
  • ENABLE_TOOL_SEARCH=false のとき、またはツール検索がないクライアント。 有効なツール定義が毎リクエスト送られるので、4章の表がそのまま当てはまります。

他のクライアントのツール数上限や読み込み方は、MCPツールは何個まで?クライアント別の上限で比較しています。

7. ツール結果のトークンを減らす:fields・minimal_output・CSV

GitHubサーバーには結果を小さくする引数が最初から用意されています。ただし、モデルがそれを使うとは限りません。ツールのスナップショットとInsidersのドキュメントから整理すると、次のとおりです。

引数・モード 対象ツール 内容
fields list_issues、list_pull_requests、search_issues、search_pull_requests、search_code、list_commits、list_releases、get_file_contents(ディレクトリのとき) 指定したフィールドだけを返す。list_issues の説明文では、body と field_values を外すと結果ごとの最大のデータがなくなると書かれている
minimal_output search_repositories 既定は true で、最小限のリポジトリ情報を返す
perPage 一覧・検索系のほとんど 1ページ1〜100件
tail_lines get_job_logs ログ末尾の行数。既定は500
CSV出力(Insiders、csv_output フラグ) 既定ツールセット内の list_* ツール 一覧をCSVで返す。目的は「応答のコンテキストを減らすこと」とされている

実際の使い方:

  • エージェントに fields を渡すよう指示する。 システムプロンプトやスキルに「IssueやPRの一覧では、本文が必要なとき以外は fields に number, title, state を指定する」と1行書くだけで、サーバーがすでに持っている機能を使えます。
  • ページを小さくする。 perPage: 10 で必要なら次のページを取るほうが、100件の結果を会話の最後まで抱え続けるより安くなります。
  • CIログには tail_lines と failed_only を使う。 ログは、多くのエージェントが読む結果の中で最も大きくなりがちです。
  • CSVは有効にする前に確認する。 GitHubは、一覧をJSONで受け取る必要があるクライアントではこの機能を有効にしないよう注意しています。

結果のサイズはリポジトリによって大きく変わるため、今回は計測していません。一般的な削り方はMCPツールの結果を小さくする8つの方法を参照してください。

8. 自分の設定を計測するスクリプト

設定を決める前に、自分の組み合わせで実際に数えましょう。以下はこの記事の計測に使ったスクリプトです。リポジトリをクローンし、gpt-tokenizer を入れて、必要ならツール名の一覧を付けて実行します。

// node measure.mjs <github-mcp-serverのクローン先> [tool,tool,...]
import fs from "node:fs";
import path from "node:path";
import { encode } from "gpt-tokenizer/encoding/o200k_base";

const dir = path.join(process.argv[2] ?? ".", "pkg/github/__toolsnaps__");
const only = process.argv[3]?.split(",");
let total = 0, readOnly = 0, n = 0;
for (const f of fs.readdirSync(dir).filter((f) => f.endsWith(".snap"))) {
  const t = JSON.parse(fs.readFileSync(path.join(dir, f), "utf8"));
  if (only && !only.includes(t.name)) continue;
  // クライアントがモデルに送る部分:name・description・入力スキーマ
  const tokens = encode(JSON.stringify({ name: t.name, description: t.description, input_schema: t.inputSchema })).length;
  total += tokens; n++;
  if (t.annotations?.readOnlyHint) readOnly += tokens;
}
console.log({ tools: n, tokens: total, readOnlyTokens: readOnly });

92ツール分のスナップショットでは { tools: 92, tokens: 22524, readOnlyTokens: 12839 }、表のGの5ツールを指定すると { tools: 5, tokens: 1726, ... } と出力されます。このディレクトリには22のローカルツールセット以外のツール(Insiders用など)のスナップショットが入ることもあるので、自分の設定に合わせてツール名を渡してください。Claudeでの正確な数が必要なら、同じ定義を tools としてAnthropicのトークン数カウントAPIに送り、ツールなしの値を引きます。

9. チェックリスト

  • [ ] エージェントが使うツールセットを把握している(既定の5つを前提にしていない)
  • [ ] 読むだけのエージェントは読み取り専用にしている(/readonly、X-MCP-Readonly、--read-only)
  • [ ] 用途が決まったエージェントは X-MCP-Tools / --tools でツールを個別指定している
  • [ ] governance・projects・actions は使うエージェントだけで有効にしている
  • [ ] ツールセット名のつづりが正確(知らない名前は黙って無視される)
  • [ ] 絶対に使わせない書き込み系ツールを X-MCP-Exclude-Tools / --exclude-tools に入れている
  • [ ] プロンプトで fields、小さな perPage、tail_lines を使うよう指示している
  • [ ] リクエスト間でツール一覧が変わらず、キャッシュが効き続ける
  • [ ] この記事の平均値ではなく、スクリプトで自分の設定を計測した

10. よくあるハマりどころ

症状 原因 対処
指定したツールセットのツールが出てこない X-MCP-Toolsets は知らない名前をエラーなしで無視する READMEの表から名前をコピーする(pulls ではなく pull_requests)
サーバーが起動しない X-MCP-Tools に存在しないツール名がある(こちらはエラーになる) READMEでツール名を確認する
--tools で指定した書き込み系ツールがない 読み取り専用モードが個別指定より優先される そのエージェントだけ読み取り専用を外すか、サーバーの設定を2つに分ける
/x/issues,pull_requests が動かない URLの {toolset} には1つしか書けない X-MCP-Toolsets ヘッダーを使う
fine-grained PATで想定よりツールが多い スコープによる絞り込みはクラシックPAT(ghp_)だけ ツールセットを明示的に指定する
CIの実行結果を1回読んだらコンテキストが跳ね上がった ジョブのログ全体が結果に入った tail_lines、failed_only を使うか、コード内で要約する
Insidersを有効にしたらトークンが増えた Insidersは実験的なツールを追加する 計測し直し、必要な機能フラグだけを有効にする

11. NodeFlareならこう解決できる

NodeFlareはMCP専用のホスティングです。GitHubリポジトリのMCPサーバーを認証付きのHTTPSエンドポイントとして公開し、プロキシ側にサーバー単位の4つのトークン削減スイッチを持っています。どれもプロキシ側で適用されるので、サーバーのコードを変える必要はありません。NodeFlareのドキュメントでは、マニフェスト(go.mod)から判定できるランタイムにGoが含まれているので、オープンソースのGitHub MCP Serverのようなリポジトリもビルド対象になります。自動判定の起動コマンドが合わない場合は、明示した entry_command が常に優先されます。ここまでの課題に、スイッチを1つずつ当てはめます。

課題1:複数ステップのGitHub作業で、途中の結果がコンテキストを埋める(4章・7章)。 tool_code_mode で Code Execution を有効にします。サーバーは run_code と search_tools を公開し、モデルは tools.* を呼ぶJavaScriptを書きます(例:Issueを一覧し、3件を読み、関連するPRを確認する)。NodeFlareがそれをサンドボックスで実行するので、途中の一覧はすべて会話に入らず、最終的な答えだけが返ります。実行は隔離されたDenoのサブプロセスで行われ、ファイルシステム・環境変数・プロセス起動は使えず、ネットワークはプロキシのコールバック先だけに限られます。既定ではタイムアウト600秒(変更可能)、1回の実行で最大50回のツール呼び出し、V8ヒープ128MBです。

課題2:ツールが多く、タスクごとに必要なものが違う(2章・6章)。 tool_search_mode を有効にします。NodeFlareは tools/list を search_tools(query) と call_tool(name, args) の2つのメタツールにまとめるので、22ツールセットをすべて有効にしても最初のコストはほぼ一定です。ツール検索を持たないクライアントでも効きます。検索は既定で語句ベースで、GEMINI_API_KEY を設定すると意味検索になり、失敗したときは語句ベースに戻ります。

課題3:エージェントごとに必要なツールが違う(5章)。 tool_list_filter_by_scope を有効にします。tools/list は、呼び出し元のNodeFlareの認証情報で呼べるツールだけを返し、スキーマは変えません。Issue整理用のボットとリリース用のボットに別々のAPIキーを渡せば、クライアントごとにヘッダーの組み合わせを管理する必要がなくなります。

課題4:一部の長い説明文。 tool_schema_slim は500文字を超える説明文を切り詰め(UTF-8安全)、名前と入力スキーマはそのまま残します。このサーバーでは該当するのは3ツールだけで、コストの大半はスキーマにあるため(2章)、これだけに頼らず上の3つと組み合わせてください。

NodeFlareはこれらのスイッチによる削減率を公表していません。8章のスクリプトとNodeFlareの利用ログで、自分の構成を計測してください。

最小の始め方:

  1. NodeFlareのダッシュボードでMCPサーバーのGitHub URLを貼り付けます。ランタイム、通信方式、起動コマンドは自動で判定・入力されます。
  2. GitHubのトークンをシークレットに登録してデプロイし、tool_code_mode(必要に応じて tool_search_mode や tool_list_filter_by_scope)を有効にします。
  3. クライアントに https://<your-server>.nodeflare.tech/mcp とNodeFlareのAPIキーを設定します。

1サーバーまで無料で試せます(Freeプラン:1サーバー、月30GB時間のコンピュート)。→ nodeflare.techで始める

12. よくある質問

GitHub MCPサーバーは何トークン使う?

既定のツールセットでは、45個のツール定義で1リクエストあたり10,618トークンです(サーバーのツールのスナップショットをo200k_baseで計測)。全ツールセットでは92ツール・22,524トークンです。Claudeのトークナイザーでは数が少し変わるので、自分の設定で計測してください。

GitHub MCPサーバーの既定のツールセットは?

context・repos・issues・pull_requests・users の5つです。ツールセットを指定しないと使われ、default,<ツールセット名> のように書けば既定に追加できます。

GitHub MCPサーバーのトークン消費を減らすには?

使うツールセットだけを有効にし、書き込まないエージェントは読み取り専用にし、作業が決まっているなら X-MCP-Tools や --tools でツールを個別に指定します。今回の計測では、5ツールの個別指定は1,726トークンで、全ツールセットの22,524トークンの約13分の1でした。

読み取り専用モードでトークンは減る?

減ります。読み取り系以外のツールがすべて外れるため、既定の設定では45ツール・10,618トークンから27ツール・6,318トークンへ、40%減りました。

GitHub MCPで一番トークンを使うツールセットは?

repos(20ツール・3,975トークン)で、次が issues(3,139)と pull_requests(2,977)です。1ツールあたりでは governance と projects が重く、projects_write は1ツールで1,567トークンあります。

リモートのGitHub MCPサーバーで複数のツールセットを選ぶには?

X-MCP-Toolsets ヘッダーにカンマ区切りで書きます(例:context,issues,pull_requests)。/x/{toolset} のURLには1つしか書けません。読み取り専用にするならURLの末尾に /readonly を付けます。

Claude CodeはGitHub MCPのツールを全部読み込む?

既定では読み込みません。Claude CodeはMCPツールを遅延させ、ツール検索で必要なときに見つけます。ENABLE_TOOL_SEARCH=false のとき、または auto モードで定義の合計がコンテキストウィンドウの10%未満のときは、有効なツールが最初から読み込まれます。

GitHub MCPツールは説明文とスキーマのどちらが重い?

スキーマです。92ツールの説明文は合計2,391トークンで、22,524トークン全体の約11%にすぎません。説明文を短くするより、ツールを減らすほうがはるかに効きます。

GitHub MCPのツール結果を小さくするには?

対応している一覧・検索ツールで fields を指定し、perPage を小さくし、ジョブのログには tail_lines や failed_only を使います。Insidersモードでは list_* の結果をCSVで受け取ることもできます。

ここでいう「MCP Token」はGitHubの個人用アクセストークンのこと?

違います。この記事はコンテキストと料金に関わるLLMのトークンの話です。個人用アクセストークンやOAuthトークンは認証情報で、セキュリティの話題になります。

まとめ

GitHub MCPサーバーのトークン消費は、設定次第で1リクエストあたり1,726〜22,524トークンまで変わります。既定のツールセットは約10,600トークンで、その大半は repos・issues・pull_requests が占め、重さの中心は説明文ではなく入力スキーマです。読むだけのエージェントは読み取り専用にし(−40%)、作業が決まっているならツールを個別指定し、governance や projects は必要なときだけ有効にしましょう。あわせて fields や小さなページを使うようエージェントに指示すれば、結果のトークンも抑えられます。サーバーをまたいでトークンを減らすツールの比較は、MCPのトークン消費を減らすツールのランキングをご覧ください。

参考資料

NodeFlare

MCP専用ホスティングサービス

GitHubにあるMCPを簡単デプロイ・簡単運用で最適化
無料で始める

他の記事

MCPトークン2026年11月17日

ツール引数は出力トークン:MCPのトークン消費で見落とされる「書く側」のコスト(write_fileとedit_fileを実測・2026年版)

MCPのツール引数は出力トークンで、単価は入力の5倍、キャッシュも効きません。公式Filesystemサーバーで1行の変更がwrite_file 5,549トークン対edit_file 49トークンになった実測、Sonnet 5.5・Opus 5.5・Fable 5.2での料金試算、ツール間の書き写し、max_tokensでの中断、書き直しの損益分岐、置換ツールのコードまで。

MCPセキュリティ2026年11月17日

MCPのきめ細かな認可:スコープでは防げないBOLAを、オブジェクト・引数・項目単位のチェックで止める【MCP Security 2026】

ツール単位のスコープでは防げない、MCPツールのオブジェクト・引数・項目単位の認可を解説。仕様の「スコープだけで十分とみなすのは誤り」、公式Python SDKを含む2026年のCVE3件、チェックの置き場所、8つのルール、検証済みPythonコード(スコープのみ4/14、多層14/14)とCedarポリシー(12/12)。

MCPホスティング2026年11月17日

Hugging Face SpacesはまだMCP Hostingに無料で使える?Gradioのmcp_server=Trueを2026年の有料化後に検証(Gradio 6.32)

2026年のHugging Face SpacesでのMCP Hosting。新規のGradio SpaceはZeroGPU以外PROが必要、無料ハードウェアは48時間でスリープ、Gradioのキューは既定で1件ずつ。Gradio 6.32で検証した /gradio_api/mcp/ の使い方、188 MB・1回約60 msの実測、Space名の接頭辞、ZeroGPUの上限、費用、Claude Code・Cursorの接続を解説。

GitHub MCPサーバーのトークン消費をツールセット別に実測:92ツールの内訳と、toolsets・読み取り専用・X-MCP-Toolsで92%減らす設定【MCP Token・2026年版】 | Blog | Nodeflare