<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="1" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
Cursor で GitHub の MCP サーバーを使う方法を 最小手順 でまとめました。 
「ツール数が多すぎる」という警告の回避方法も紹介します。
<hr data-line="6" class="code-line">
<h2 id="1.-github-personal-access-token-%E3%82%92%E7%94%A8%E6%84%8F" data-line="8" class="code-line">
<a class="header-anchor-link" href="#1.-github-personal-access-token-%E3%82%92%E7%94%A8%E6%84%8F" aria-hidden="true"></a> 1. GitHub Personal Access Token を用意</h2>
<ol data-line="10" class="code-line">
<li data-line="10" class="code-line">
<a href="https://github.com/settings/personal-access-tokens" target="_blank" rel="nofollow noopener noreferrer">GitHub → Developer settings → Personal Access Tokens</a> から PAT を作成</li>
<li data-line="11" class="code-line">最小限の権限で OK（例: リポジトリ読み取りなら <code>repo</code> の read 権限だけ）</li>
</ol>
<hr data-line="13" class="code-line">
<h2 id="2.-mcp.json-%E3%82%92%E4%BD%9C%E6%88%90" data-line="15" class="code-line">
<a class="header-anchor-link" href="#2.-mcp.json-%E3%82%92%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 2. <code>mcp.json</code> を作成</h2>
保存場所の例:
<ul data-line="19" class="code-line">
<li data-line="19" class="code-line">macOS / Linux: <code>~/.cursor/mcp.json</code>
</li>
<li data-line="20" class="code-line">Windows: <code>%USERPROFILE%\.cursor\mcp.json</code>
</li>
</ul>
まずは基本設定：
<div class="code-block-container">
<div class="code-block-filename-container">mcp.json</div>
<pre class="language-json"><code class="language-json code-line" data-line="24">{
 "mcpServers": {
 "github": {
 "command": "npx",
 "env": {
 "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
 }
 }
 }
}
</code></pre>
</div><hr data-line="37" class="code-line">
<h2 id="3.-%E3%83%84%E3%83%BC%E3%83%AB%E6%95%B0%E8%B6%85%E9%81%8E%E3%82%A8%E3%83%A9%E3%83%BC%E3%82%92%E5%9B%9E%E9%81%BF%E3%81%99%E3%82%8B" data-line="39" class="code-line">
<a class="header-anchor-link" href="#3.-%E3%83%84%E3%83%BC%E3%83%AB%E6%95%B0%E8%B6%85%E9%81%8E%E3%82%A8%E3%83%A9%E3%83%BC%E3%82%92%E5%9B%9E%E9%81%BF%E3%81%99%E3%82%8B" aria-hidden="true"></a> 3. ツール数超過エラーを回避する</h2>
「Exceeding total tools limit」という警告が出たら、<code>args</code> を追加します。 
<img src="https://storage.googleapis.com/zenn-user-upload/b4cb4d01daa9-20250828.png" class="md-img" loading="lazy">
<div class="code-block-container">
<div class="code-block-filename-container">mcp.json</div>
<pre class="language-json"><code class="language-json code-line" data-line="43">{
 "mcpServers": {
 "github": {
 "command": "npx",
 "args": ["-y", "@modelcontextprotocol/server-github"],
 "env": {
 "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
 }
 }
 }
}
</code></pre>
</div>これで不要なツールが読み込まれず、警告を避けやすくなります。
<hr data-line="59" class="code-line">
<h2 id="4.-%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" data-line="61" class="code-line">
<a class="header-anchor-link" href="#4.-%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" aria-hidden="true"></a> 4. 動作確認</h2>
<ol data-line="63" class="code-line">
<li data-line="63" class="code-line">Cursor を再起動</li>
<li data-line="64" class="code-line">「GitHub のリポジトリを探して」など試す</li>
<li data-line="65" class="code-line">うまく動かないときは以下を確認
<ul data-line="66" class="code-line">
<li data-line="66" class="code-line">PAT の権限</li>
<li data-line="67" class="code-line">Node.js / npx の PATH</li>
<li data-line="68" class="code-line">ネットワーク設定</li>
</ul>
</li>
</ol>
<hr data-line="70" class="code-line">
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="72" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<ul data-line="74" class="code-line">
<li data-line="74" class="code-line">
<code>mcp.json</code> に GitHub サーバーを定義するだけで使える</li>
<li data-line="75" class="code-line">ツール数の警告は <code>args</code> を追加して回避</li>
<li data-line="76" class="code-line">最小権限の PAT を使うのがおすすめ</li>
</ul>
これで Cursor から GitHub を安全に扱えます ✅

CursorでGitHub MCPを設定する手順

1. GitHub Personal Access Token を用意

3. ツール数超過エラーを回避する

Discussion