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になります。
目次
- GitHub MCPサーバーのトークン消費は何で決まるか
- 実測:ツールセット別のトークン数
- 特に重いツール
- 設定別のトークン数と費用の比較
- ツールセット・ツール・読み取り専用モードの設定方法
- Claude Codeのツール検索との関係
- ツール結果のトークンを減らす:fields・minimal_output・CSV
- 自分の設定を計測するスクリプト
- チェックリスト
- よくあるハマりどころ
- NodeFlareならこう解決できる
- よくある質問
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の利用ログで、自分の構成を計測してください。
最小の始め方:
- NodeFlareのダッシュボードでMCPサーバーのGitHub URLを貼り付けます。ランタイム、通信方式、起動コマンドは自動で判定・入力されます。
- GitHubのトークンをシークレットに登録してデプロイし、
tool_code_mode(必要に応じてtool_search_modeやtool_list_filter_by_scope)を有効にします。 - クライアントに
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のトークン消費を減らすツールのランキングをご覧ください。
