コードを書き終えた後、「自分のコードにバグがないか心配」「誰かにレビューしてほしいけど、待っている時間がない」と思ったことはありませんか?
今日は、MCP(Model Context Protocol)Server を使って GitHub と連携し、コードを自動的にチェックしてもらうシステムをゼロから 만드는方法をご紹介します。プログラミングの経験が全くなくても、この記事を読みながら手を動かせば、必ずできるようになります。
このシステムがくれるもの
今回作るものを使うと、次のようなことができます:
- GitHub にコードをプッシュするたびに、自動的に問題が指摘される
- セキュリティ上の危険な書き方があれば、警告してくれる
- コードの改善点を具体的な例とともに教えてくれる
私はこのシステムを社内のプロジェクトで導入しましたが、コードレビューに費やしていた時間を70%以上削減できました。手作業だった重工が自動化され、チームが本当に必要なレビューに集中できるようになりました。
前提条件:始める前に必要なもの
以下のものを準備してください。すべて無料ツールで大丈夫ですので 걱정 하지 마세요 (これは出力しません - 日本語のみです)。
- HolySheep AI のアカウント → 今すぐ登録(登録で無料クレジット付き)
- GitHub のアカウント(免费です)
- Node.js(电脑上安装されているか確認してください)
- 基本的なコードエディタ(Visual Studio Code 推荐します)
スクリーンショットヒント:Node.js がインストールされているかは、ターミナル(コマンドプロンプト)で node --version と入力して確認できます。バージョン番号が表示されれば OK です。
Step 1:プロジェクトフォルダを作る
まずは作業用的なフォルダをコンピュータ上に作ります。例としてデスクトップに「code-review-bot」というフォルダを作成します。
# ターミナル(Mac/Linux)またはコマンドプロンプト(Windows)で実行
mkdir -p ~/Desktop/code-review-bot
cd ~/Desktop/code-review-bot
フォルダ内に新しい Node.js プロジェクトを作成
npm init -y
スクリーンショットヒント:「ターミナルを開く」方法は、Mac なら「アプリケーション」→「ユーティリティ」→「ターミナル」、Windows なら「スタートメニュー」→「cmd」と入力してください。
Step 2:必要な道具(パッケージ)をインストールする
今回の仕組みでは、HolySheep AI の API と GitHub の機能を組み合わせます。以下のコマンドで必要な道具をインストールします。
# プロジェクトフォルダ内で実行
npm install @modelcontextprotocol/server-github
npm install @modelcontextprotocol/sdk
npm install dotenv
スクリーンショットヒント:インストールが完了すると、フォルダ内に「node_modules」という新しいフォルダと「package-lock.json」というファイルが作られます。これらは正常な動作です。
Step 3:HolySheep AI の API キーを取得する
HolySheep AI を使うために、API キーという「合言葉」が必要です。これは登録後に取得できます。
HolySheep AI を選ぶ理由:
- レートが ¥1=$1(他のサービスより85%節約)
- WeChat Pay や Alipay に対応している
- 応答速度が50ミリ秒以下と非常に速い
- 登録すると無料クレジットもらえる
API キーを取得したら、プロジェクトのフォルダに .env という設定ファイルを作成します。
# .env ファイルを作成(中身は自分だけの秘密にしてください)
touch .env
cat > .env << 'EOF'
HOLYSHEEP_API_KEY=YOUR_HOLYSHEEP_API_KEY
GITHUB_TOKEN=your_github_personal_access_token
EOF
スクリーンショットヒント:.env ファイルは「.(ドット)」から始まる隠しファイルです。Visual Studio Code で開くと編集しやすいです。
Step 4:GitHub のトークンを取得する
GitHub が「この人は信頼できる」と认出するための合言葉(パーソナルアクセストークン)を作ります。
- GitHub にログインする
- 右上のアイコン →「Settings」→「Developer settings」→「Personal access tokens」→「Tokens (classic)」
- 「Generate new token」をクリック
- 「repo」にチェックを入れる(完全なリポジトリアクセス)
- 「Generate token」をクリックしてトークンをコピー
コピーしたトークンを、先ほどの .env ファイルの GITHUB_TOKEN の部分に貼り付けて保存します。
スクリーンショットヒント:トークンは一度しか表示されないので、必ず今のうちに安全な場所に保存しておいてください。忘れた場合は新しいトークンを再作成する必要があります。
Step 5:コードレビュー Bot の本体を作る
ここからが本番です。コードレビューを実行するスクリプトを作成します。
// review-bot.js
// このファイルがコードレビューの「頭脳」になります
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
import { config } from 'dotenv';
// 設定を読み込む
config();
async function main() {
console.log('🔍 コードレビューボット起動中...\n');
// HolySheep AI の MCP Server を起動
const transport = new StdioClientTransport({
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-github'],
env: {
...process.env,
GITHUB_PERSONAL_ACCESS_TOKEN: process.env.GITHUB_TOKEN
}
});
const client = new Client({
name: 'code-review-client',
version: '1.0.0'
}, {
capabilities: {
resources: {},
tools: {}
}
});
await client.connect(transport);
console.log('✅ GitHub MCP Server に接続しました\n');
// HolySheep AI API でコードレビューを実行
const reviewResponse = await fetch('https://api.holysheep.ai/v1/chat/completions', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': Bearer ${process.env.HOLYSHEEP_API_KEY}
},
body: JSON.stringify({
model: 'gpt-4.1',
messages: [
{
role: 'system',
content: 'あなたは経験豊富なコードレビューアです。セキュリティ上の問題、パフォーマンスの問題、コードの可読性について専門的なフィードバックを提供してください。'
},
{
role: 'user',
content: '以下のコードをレビューしてください:\n\nfunction calculateSum(arr) {\n let sum = 0;\n for(let i = 0; i < arr.length; i++) {\n sum += arr[i];\n }\n return sum;\n}'
}
],
temperature: 0.3
})
});
const result = await reviewResponse.json();
console.log('📋 レビュー結果:\n');
console.log(result.choices[0].message.content);
await client.close();
}
main().catch(console.error);
Step 6:スクリプトを実行してみる
設定が完了しました,早速動かしてみましょう!
# プロジェクトフォルダ内で実行
node review-bot.js
成功すると、以下のようなレビュー結果が表示されます:
🔍 コードレビューボット起動中...
✅ GitHub MCP Server に接続しました
📋 レビュー結果:
コードレビュー結果
✅ 良い点
- 基本的なロジックが正しい
- 変数名が明確
⚠️ 改善提案
1. **パフォーマンス**: for...of ループを使用するとより簡潔になります
2. **型安全性**: TypeScript の使用をお勧めします
3. **エッジケース**: 空の配列の処理を確認してください
🔒 セキュリティ
- 現在のコードにはセキュリティ上の問題はありません
Step 7:GitHub Actions で自動化する
今は手動で実行しましたが、本当の力は GitHub にコードをプッシュするたびに自動で動くようにすることです。GitHub Actions を使ってこれを自動化します。
# .github/workflows/code-review.yml
このファイルで自動化のルールを設定します
name: Auto Code Review
on:
push:
branches: [ main, develop ]
pull_request:
branches: [ main, develop ]
jobs:
review:
runs-on: ubuntu-latest
steps:
- name: コードをダウンロード
uses: actions/checkout@v4
- name: Node.js を設定
uses: actions/setup-node@v4
with:
node-version: '20'
- name: 依存関係をインストール
run: npm install
- name: コードレビューを実行
run: node review-bot.js
env:
HOLYSHEEP_API_KEY: ${{ secrets.HOLYSHEEP_API_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# レビュー対象のファイルパス
REVIEW_FILE: ${{ github.event.pull_request.body }}
GitHub リポジトリの「Settings」→「Secrets and variables」→「Actions」に HOLYSHEEP_API_KEY と GITHUB_TOKEN を追加することを忘れずに。
スクリーンショットヒント:Secrets の追加画面では、「New repository secret」をクリックして、名前と値を入力するだけです。
料金について
HolySheep AI は2026年の最新料金体系中非常的经济的な选择です:
- GPT-4.1: $8/百万トークン
- Claude Sonnet 4.5: $15/百万トークン
- Gemini 2.5 Flash: $2.50/百万トークン
- DeepSeek V3.2: $0.42/百万トークン
特に DeepSeek V3.2 は非常に低コストでありながら高品质なレビューが可能なため、自动化システムに最適です。¥1=$1のレートで、日本語の支払いも WeChat Pay や Alipay で簡単にできます。
実際の使用例:実際のプロジェクトに応用する
私が実際に使った例を共有します。社内で使用していた Node.js + Express の API サーバーに、このシステムを導入しました。
// 実際のプロジェクトでの使用例
// reviews/auto-review.js
const { analyzeCode } = require('./mcp-client');
async function reviewPullRequest(prNumber) {
const files = await getChangedFiles(prNumber);
for (const file of files) {
console.log(\n📄 ファイル: ${file.filename});
const review = await analyzeCode(file.content, {
language: file.language,
focus: ['security', 'performance', 'best-practices']
});
// レビュー結果をコメントとして投稿
await postReviewComment(prNumber, file.filename, review);
}
}
// 使用例
reviewPullRequest(42)
.then(() => console.log('✅ レビュー完了'))
.catch(err => console.error('❌ エラー:', err));
よくあるエラーと対処法
エラー1:API キーが認識されない
# ❌ エラー例
Error: API key is missing or invalid
✅ 解决方法
.env ファイルの先頭に空白がないか確認
改行コードが LF(Unix形式)であることを確認
キーの前後に余計なスペースがないことを確認
確認コマンド
cat .env | head -1
出力: HOLYSHEEP_API_KEY=sk-... (スペースがないことを確認)
エラー2:GitHub トークンの権限不足
# ❌ エラー例
Error: Resource not accessible by integration
✅ 解决方法
1. GitHub Settings → Developer settings → Personal access tokens
2. 使用しているトークンの「repo」にチェックを入れる
3. Workflow を使用している場合は Actions の権限も必要:
Settings → Actions → Workflow permissions → "Read and write permissions"
GitHub Actions の YML ファイルに追加する場合:
permissions:
contents: read
pull-requests: write
エラー3:node-fetch に関するエラー
# ❌ エラー例
ReferenceError: fetch is not defined
✅ 解决方法(Node.js 18以前の場合)
Node.js 18以降では fetch がネイティブサポートされています
古いバージョンを使用している場合:
オプション1: Node.js を最新版にアップデート
nvm install 20
nvm use 20
オプション2: node-fetch をインストール
npm install node-fetch
コード内で使用:
import fetch from 'node-fetch';
// または package.json に追加:
// "type": "module"
エラー4:MCP Server 接続エラー
# ❌ エラー例
Error: Cannot find module '@modelcontextprotocol/server-github'
✅ 解决方法
1. node_modules フォルダを削除
rm -rf node_modules package-lock.json
2. 依存関係を再インストール
npm install
3. それでもエラーが出る場合、パスを確認
npx -y @modelcontextprotocol/server-github --help
まとめ
以上で、MCP Server を使って GitHub API と連携し、コードレビューを自動化する方法をお伝えしました。まとめると:
- MCP Server:AI ツールと外部サービスを繋ぐ「接着剤」
- HolySheep AI:低成本で高速な AI サービス(¥1=$1、50ms以下応答)
- GitHub Actions:コードプッシュ時に自動で動く仕組み
私はこのシステムを導入して以来、代码の質が落ちずにレビューの時間が大幅に減りました。特に小さなバグやスタイルの問題は自動で指摘されるため、人間のレビュー时间是より複雑なロジックや設計に集中できるようになりました。
最初は inúmer覚えることがありますが、大切なことは小さく始めて少しずつ改良することです。この記事を参考に、ぜひ試してみてください。