GitHub MCP Server

TypeScript で書かれたカスタム MCP（Model Context Protocol）サーバーで、Claude を GitHub の REST API に接続します。

できること

Claude が呼び出せる 6 つのツールを公開しています。

Related MCP server: remote-mcp-oauth-github

1. GitHub Personal Access Token を生成する

1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens にアクセスします

2. 必要な最小限の権限でトークンを作成します:

   • Contents: Read（get_file_content 用）

   • Issues: Read and write（list_issues/create_issue 用）

   • Metadata: Read（常に必須）

3. 生成されたトークンをコピーします（github_pat_... で始まります）

セキュリティのヒント: トークンをリポジトリにコミットしないでください。環境変数を使用してください。

2. インストールとビルド

npm install
npm run build

これにより、サーバーの実行ファイルである build/index.js が生成されます（MCP の標準プロトコルである stdio 経由で通信します）。

3. ローカルでテストする（オプション、Claude なし）

export GITHUB_PERSONAL_ACCESS_TOKEN="seu_token_aqui"
npm start

stderr に GitHub MCP server rodando via stdio. と表示されれば、正常に動作しています。ツールを対話的にテストするには、MCP Inspector を使用してください:

npx @modelcontextprotocol/inspector node build/index.js

4. Claude Desktop に接続する

Claude Desktop の設定ファイルを編集します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下を追加します:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/caminho/absoluto/para/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Claude Desktop を再起動します。GitHub のツールが、会話のツールアイコン（🔨）に表示されるはずです。

5. 次のステップ（ポートフォリオを拡張・強化するアイデア）

• 書き込み用ツールを追加する: create_pull_request、merge_pull_request、create_branch

• per_page だけではなく、実際のページネーション（カーソルベース）を追加する

• レート制限とキャッシュ（GitHub は認証済みで 5000 req/h に制限しています）

• Vitest/Jest による自動テスト

• push のたびに lint + テスト + ビルドを実行する GitHub Actions の CI

• npm パッケージとして公開する（npx github-mcp-server）

• サーバーを Docker 化する（他の DevOps プロジェクトとつなげる良いきっかけになります）

プロジェクトの構造

github-mcp-server/
├── src/
│   └── index.ts      # lógica do servidor e definição das tools
├── build/             # gerado pelo `npm run build`
├── package.json
├── tsconfig.json
└── README.md