概要

github-mcp-server をローカルでビルドし、claude mcp コマンドを使用してパスを設定する方法の備忘録

前提条件

Goがインストールされていること
GitHub Personal Access Tokenを生成していること

github-mcp-server をローカルでビルド

github-mcp-server のソースコードをクローンし、実行可能なバイナリをビルドする

リポジトリのクローンとバイナリのビルド

# 作業用ディレクトリの作成（例: ホームディレクトリにmcp-serversフォルダを作成）
mkdir -p ~/mcp-servers

# 作成したディレクトリに移動
cd ~/mcp-servers/ 

# github-mcp-server リポジトリをクローン
git clone https://github.com/github/github-mcp-server.git

# クローンしたディレクトリに移動
cd github-mcp-server

# 必要なGoモジュールをダウンロードし、依存関係を解決
go mod tidy

# バイナリをビルドし、指定したパス（例: /usr/local/bin/）に出力
# 必要に応じて 'sudo' を使用するか、実行パスが通っている他のディレクトリを指定する
sudo go build -o /usr/local/bin/github-mcp-server ./cmd/github-mcp-server/

claude mcp コマンドを使用してパスの設定

ビルドした github-mcp-server を claude mcp 経由で登録し、設定を確認する

github-mcp-server の設定登録

# github-mcp-server の設定をClaude MCPに登録
# <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN> はあなたのGitHub Personal Access Tokenに置き換える
claude mcp add github --scope user -e GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN> -- /usr/local/bin/github-mcp-server stdio

登録済みのMCPサーバーの一覧を表示

# 登録済みのMCPサーバーの一覧を表示して設定を確認
claude mcp list

期待される出力例:

github: /usr/local/bin/github-mcp-server stdio

MCPサーバーの登録確認

Claude Codeのターミナル内で /mcp コマンドを実行し、MCPサーバーが正常に接続されていることを確認する

接続の確認

# Claude Codeを開始
claude

# Claude Codeのターミナル内でステータスの確認
/mcp

期待される出力例:

╭──────────────────────────────────────────────────────────────────────────╮
│ Manage MCP servers                                                       │
│                                                                          │
│ ❯ 1. github  ✔ connected · Enter to view details                         │
╰──────────────────────────────────────────────────────────────────────────╯

✔ connected と表示されていれば、MCPサーバーの登録と接続は完了

参考