Github Mcp Server

Github MCP Server

🔗 MCP Market で見る
🔗 MCP Registry で見る
📦 npm で利用可能

AI アシスタントと開発者向けに、29 個の Git 操作と 11 個のワークフローの組み合わせを提供するModel Context Protocol（MCP）サーバーです。このサーバーは、標準化されたインターフェースを通じて包括的な Git リポジトリ管理機能を提供し、AI モデルと開発者が複雑なバージョン管理ワークフローを安全に管理できるようにします。

🚀 簡単なインストール

オプション 1：.vscode/mcp.json（推奨）

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "npx",
      "args": ["-y", "@0xshariq/github-mcp-server@latest"]
    }
  }
}

オプション 2：CLI 向け

pnpm i -g @0xshariq/github-mcp-server@latest

# Test Commands After Installation
gstatus
gadd
glog 10
gpush

オプション 3：シンボリックリンク（代替手段 — パッケージマネージャー不要）

# Clone and setup
git clone https://github.com/0xshariq/github-mcp-server.git
cd github-mcp-server
npm install && npm run build

# Create symbolic links (cross-platform)
./setup-symbolic.sh --user          # User installation
# OR
sudo ./setup-symbolic.sh           # System-wide (Linux/macOS)

# Test the installation
gstatus
glist

🛠️ 問題が発生していますか？ インストール後にコマンドが動作しない場合は、「command not found」エラー、パスの競合、PNPM の問題、シンボリックリンクによる代替手段など、よくある問題の解決方法をまとめた**完全なトラブルシューティングガイド**をご覧ください。

🎯 概要

GitHub MCP Server は AI アシスタントと Git リポジトリをつなぎ、開発者の生産性を高める強力なツールを提供します。次の機能を備えています。

• 標準化された MCP インターフェースによる 安全な Git 操作（29 個の操作）
• タグ、マージ、リベース、チェリーピック、blame、bisect などの高度な操作を含む 完全なバージョン管理機能
• 開発者の生産性を高める 31 個のワークフローの組み合わせ
• 高度な開発者向けツール（バックアップ、クリーンアップ、ワークフローの自動化）
• よくある Git のミスを防ぐ エラー処理と検証
• VS Code や GitHub Copilot などの AI アシスタントとの 直接統合
• ターミナルからのアクセスと自動化に使える CLI ラッパー

🚀 機能の概要

このサーバーは、次の 2 つの主なカテゴリを通じて包括的な Git リポジトリ管理機能を提供します。

📁 基本的な Git 操作（17 個の操作）

日常的に使う重要な Git コマンドを bin/basic/ にまとめています。詳しくは、詳細なドキュメントを掲載した 基本操作ガイド をご覧ください。

• ファイル管理：ステージングエリアへのファイルの追加と削除
• リポジトリ情報：状態、履歴、差分
• コミット操作：コミットの作成、プッシュ、プル
• ブランチ管理：ブランチの作成と切り替え
• リモート管理：リモートの追加、削除、設定
• スタッシュ操作：変更の一時保存
• リセット操作：リポジトリの状態管理

🚀 高度な Git 操作（12 個の操作）

高度なワークフローと自動化機能を bin/advanced/ にまとめています。包括的なドキュメントについては、高度なワークフローガイド をご覧ください。

• ワークフローの組み合わせ：一連の処理（add→commit→push）、クイックコミット、同期操作
• 開発ツール：スマートな開発ワークフロー、バックアップシステム
• 高度な Git 機能：タグ、マージ、リベース、チェリーピック、blame、bisect
• メンテナンスと安全性：リポジトリのクリーンアップ、最適化、バックアップ管理
• プロフェッショナルなワークフロー：リリース管理、ホットフィックス手順、チームでの共同作業

🛠️ インストール

Windows、macOS、WSL、および各種プラットフォーム向けの詳しいインストールガイドは、markdown/INSTALLATION.md をご覧ください。

🏗️ プロジェクトの構成とアーキテクチャ

GitHub MCP Server は、明確さと段階的な学習を考慮して構成されています。

github-mcp-server/
├── src/
│   ├── index.ts              # MCP server (29 tool registrations, schema definitions)
│   └── github.ts             # Git operations engine (all 29 implementations)
├── bin/
│   ├── basic/                # 📁 17 Essential Git Operations
│   │   ├── README.md         # Comprehensive basic operations guide
│   │   ├── gadd.js           # Add files (git add)
│   │   ├── gcommit.js        # Create commits (git commit)
│   │   ├── gpush.js          # Push changes (git push)
│   │   ├── gpull.js          # Pull changes (git pull)
│   │   ├── gstatus.js        # Repository status (git status)
│   │   ├── gbranch.js        # Branch management (git branch)
│   │   ├── gcheckout.js      # Branch switching (git checkout)
│   │   ├── glog.js           # Commit history (git log)
│   │   ├── gdiff.js          # Show differences (git diff)
│   │   ├── gstash.js         # Stash operations (git stash)
│   │   ├── gpop.js           # Apply stash (git stash pop)
│   │   ├── greset.js         # Reset operations (git reset)
│   │   ├── gclone.js         # Clone repositories (git clone)
│   │   ├── gremote.js        # Remote management (git remote)
│   │   └── ginit.js          # Initialize repository (git init)
│   └── advanced/             # 🚀 13 Advanced Workflows & Automation
│       ├── README.md         # Comprehensive advanced workflows guide
│       ├── gflow.js          # Complete workflow (add→commit→push)
│       ├── gquick.js         # Quick commit workflow
│       ├── gsync.js          # Sync workflow (pull→push)
│       ├── gdev.js           # Development session management
│       ├── gworkflow.js      # Professional workflow combinations
│       ├── gfix.js           # Smart fix and patch workflows
│       ├── gfresh.js         # Fresh start workflows
│       ├── gbackup.js        # Backup and safety operations
│       ├── gclean.js         # Repository cleanup and optimization
│       ├── gsave.js          # Save and preserve workflows
│       ├── glist.js          # Tool discovery and help system
│       ├── grelease.js       # Release management workflows
│       └── common.js         # Shared utilities and helpers
├── markdown/
│   ├── INSTALLATION.md      # Detailed installation guide
│   ├── DEPLOY.md            # Production deployment guide
│   ├── DOCKER.md            # Docker setup and deployment guide
│   └── QUICK_REFERENCES.md  # Copy-paste command reference
├── mcp-cli.js               # Enhanced CLI wrapper (organized by structure)
├── package.json             # Project configuration & npm scripts
├── tsconfig.json            # TypeScript configuration
└── README.md                # This comprehensive guide

📖 ドキュメント構成

• bin/basic/README.md - 17 の基本的な Git 操作を網羅した完全ガイド
• bin/advanced/README.md - 高度なワークフローに関する包括的なドキュメント
• markdown/INSTALLATION.md - すべてのプラットフォーム向けのステップごとのインストール手順
• markdown/TROUBLESHOOTING.md - 🛠️ 完全なトラブルシューティングガイド - よくある問題の解決策
• markdown/MCP_UNIVERSAL_CONFIG.md - すべての LLM クライアント向けのユニバーサル MCP 設定
• markdown/QUICK_REFERENCES.md - すぐに参照できるコピー＆ペースト用コマンド
• markdown/DOCKER.md - Docker のセットアップ、デプロイ、コンテナ化
• markdown/DEPLOY.md - 本番環境へのデプロイとホスティング戦略

🔧 技術アーキテクチャ

📡 MCP サーバーコア (src/index.ts)

• 29 個のツール登録と完全な JSON スキーマ
• 操作の追跡とパフォーマンス監視を備えた拡張メタデータ
• 型安全性を確保する Zod スキーマによる入力検証
• タイムアウト保護とわかりやすいメッセージを備えたエラー処理パイプライン
• 環境の正規化によるクロスプラットフォーム対応

⚙️ Git 操作エンジン (src/github.ts)

• 29 個すべての Git 操作を包括的に実装
• セキュリティ機能 - コマンドインジェクションの防止と入力のサニタイズ
• よくあるシナリオに対応したコンテキスト認識型メッセージによる強化されたエラー処理
• パフォーマンス監視 - 操作時間の追跡とロギング
• 安全性チェック - リポジトリの検証とファイルの存在確認

🖥️ 強化された CLI システム

• スマートな整理 - 基本操作と高度な操作にツールを分類
• ディレクトリを考慮したヘルプ - 詳細なガイダンスを記載した各 README ファイルへの参照
• 段階的な学習 - 基本操作から高度な操作へ進む明確な道筋
• ツールの検索 - カテゴリーで絞り込める拡張版 glist コマンド

🛡️ エラー処理と安全性

• 🔍 リポジトリの検証：ディレクトリが有効な Git リポジトリであることを確認します
• 📁 ファイルの存在確認：Git 操作の前にファイルが存在することを検証します
• ⏱️ タイムアウト保護：操作に 30 秒のタイムアウトを設定します
• 🚫 入力のサニタイズ：コマンドインジェクションを防止します
• 📝 詳細なエラーメッセージ：明確で、対処方法がわかるエラーの説明を表示します

🛠️ トラブルシューティング

インストールで問題が発生したり、コマンドが動作しなかったりしていますか？お任せください！包括的なトラブルシューティングガイドでは、よくある問題の解決策をすべて紹介しています。

🚨 最もよくある問題とすぐに試せる解決策

問題	すぐに試せる解決策
💥 command not found エラー	unset command_not_found_handle
📁 PNPM とのパスの競合	グローバルディレクトリから /5/ を削除します
🔗 コマンドを実行せずにヘルプが表示される	コマンド名を渡すようラッパースクリプトを更新します
🚫 権限が拒否される	chmod +x ~/.local/share/pnpm/g*

👉 詳細な解決策、手順ごとの修正方法、診断ツールについては、完全なトラブルシューティングガイドをご覧ください

🆘 クイック診断

# Test if commands are working
gstatus                    # Should show repository status
env gstatus               # Alternative if above fails
which gstatus             # Should show path to command

# If still having issues, see TROUBLESHOOTING.md for complete solutions

ライセンス

ISC ライセンス

作者

Model Context Protocol をサポートする AI アシスタントで使用するために作成されました。