{"_id":"github-mcp-server","_rev":"6-dd4b28da7d8125fd2bf765b5f1037924","name":"github-mcp-server","dist-tags":{"latest":"1.8.7"},"versions":{"1.8.4":{"name":"github-mcp-server","version":"1.8.4","keywords":["git","mcp","model-context-protocol","cli","github","workflow","automation","ai-assistant","git-tools","developer-tools"],"author":{"name":"Sharique Chaudhary"},"license":"ISC","_id":"github-mcp-server@1.8.4","maintainers":[{"name":"giglepeople","email":"giglepeople@gmail.com"}],"homepage":"https://github.com/jungchihoon/github-mcp-server#readme","bugs":{"url":"https://github.com/jungchihoon/github-mcp-server/issues"},"bin":{"gms":"mcp-cli.js","gadd":"mcp-cli.js","gdev":"mcp-cli.js","gfix":"mcp-cli.js","glog":"mcp-cli.js","gpop":"mcp-cli.js","gtag":"mcp-cli.js","gdiff":"mcp-cli.js","gflow":"mcp-cli.js","ginit":"mcp-cli.js","glist":"mcp-cli.js","gpull":"mcp-cli.js","gpush":"mcp-cli.js","gsave":"mcp-cli.js","gsync":"mcp-cli.js","gblame":"mcp-cli.js","gclean":"mcp-cli.js","gclone":"mcp-cli.js","gfresh":"mcp-cli.js","gmerge":"mcp-cli.js","gquick":"mcp-cli.js","greset":"mcp-cli.js","gstash":"mcp-cli.js","gbackup":"mcp-cli.js","gbisect":"mcp-cli.js","gbranch":"mcp-cli.js","gcherry":"mcp-cli.js","gcommit":"mcp-cli.js","grebase":"mcp-cli.js","gremote":"mcp-cli.js","gstatus":"mcp-cli.js","grelease":"mcp-cli.js","gcheckout":"mcp-cli.js","gworkflow":"mcp-cli.js","github-mcp-server":"mcp-cli.js"},"dist":{"shasum":"2b63900809a82eaedea9278a0252c4ca9d413f4e","tarball":"https://registry.npmjs.org/github-mcp-server/-/github-mcp-server-1.8.4.tgz","fileCount":40,"integrity":"sha512-Pcpa7PuBm5kZFvyMIgHorD82mIsaGIWlzjiEaA2BSHiAoekhZD9qo4/2cAzB5uXkLm0krNrEvM9pzlNK23uhkQ==","signatures":[{"sig":"MEUCIQDk9k8pgjCVKo1be32YXz7E/gLvhj3Rp4wUc57/aP+oeQIgOTQLWuYWbiLpmaBdXIor74zfj89lwLC/ct0s+3wp9os=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":355907},"main":"dist/index.js","gitHead":"1cddfc23a3c0181c9b7a5f91d570b43d036699b4","scripts":{"dev":"tsc -w & node dist/index.js","mcp":"node mcp-cli.js","build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","prepack":"pnpm run build","rebuild":"pnpm run clean && pnpm run build","version":"echo $npm_package_version","postpack":"pnpm run clean","dev:build":"tsc && node dist/index.js","start:mcp":"node dist/index.js","dev:install":"pnpm run build && pnpm run install:global","install:global":"pnpm run build && npm install -g .","prepublishOnly":"pnpm run build","uninstall:global":"npm uninstall -g github-mcp-server"},"_npmUser":{"name":"giglepeople","email":"giglepeople@gmail.com"},"repository":{"url":"git+https://github.com/jungchihoon/github-mcp-server.git","type":"git"},"_npmVersion":"10.5.0","description":"A comprehensive Model Context Protocol (MCP) server that provides Git repository management capabilities for AI assistants and automation tools. Includes 29 Git operations + 11 workflow combinations with complete CLI alias system and advanced developer pr","directories":{},"_nodeVersion":"20.11.1","dependencies":{"zod":"^4.0.5","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.15.1","@modelcontextprotocol/inspector":"^0.16.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/github-mcp-server_1.8.4_1754045548063_0.5980979388146623","host":"s3://npm-registry-packages-npm-production"}},"1.8.5":{"name":"github-mcp-server","version":"1.8.5","keywords":["git","mcp","model-context-protocol","cli","github","workflow","automation","ai-assistant","git-tools","developer-tools"],"author":{"name":"Sharique Chaudhary"},"license":"ISC","_id":"github-mcp-server@1.8.5","maintainers":[{"name":"giglepeople","email":"giglepeople@gmail.com"}],"homepage":"https://github.com/jungchihoon/github-mcp-server#readme","bugs":{"url":"https://github.com/jungchihoon/github-mcp-server/issues"},"bin":{"gms":"mcp-cli.js","gadd":"mcp-cli.js","gdev":"mcp-cli.js","gfix":"mcp-cli.js","glog":"mcp-cli.js","gpop":"mcp-cli.js","gtag":"mcp-cli.js","gdiff":"mcp-cli.js","gflow":"mcp-cli.js","ginit":"mcp-cli.js","glist":"mcp-cli.js","gpull":"mcp-cli.js","gpush":"mcp-cli.js","gsave":"mcp-cli.js","gsync":"mcp-cli.js","gblame":"mcp-cli.js","gclean":"mcp-cli.js","gclone":"mcp-cli.js","gfresh":"mcp-cli.js","gmerge":"mcp-cli.js","gquick":"mcp-cli.js","greset":"mcp-cli.js","gstash":"mcp-cli.js","gbackup":"mcp-cli.js","gbisect":"mcp-cli.js","gbranch":"mcp-cli.js","gcherry":"mcp-cli.js","gcommit":"mcp-cli.js","grebase":"mcp-cli.js","gremote":"mcp-cli.js","gstatus":"mcp-cli.js","grelease":"mcp-cli.js","gcheckout":"mcp-cli.js","gworkflow":"mcp-cli.js","github-mcp-server":"mcp-cli.js"},"dist":{"shasum":"4c1d2482c3f33af41f3085db422a76efa1f1ae36","tarball":"https://registry.npmjs.org/github-mcp-server/-/github-mcp-server-1.8.5.tgz","fileCount":40,"integrity":"sha512-Apuhp7Hxra58pTcxVGbqdpgZPMAWjlZlYVPYvyqhu/ENgzWMB+So9OBCA2VNk3RRnze3EaeN5U7vB4Wn0dl6Xw==","signatures":[{"sig":"MEUCIELXYzeEh/iw1R+QaVJAcocZVOPnmBIv1D8pafbeKrdgAiEAjdov69YoplN712JnIJwC1e/VfgPxS8HRO3aTWw+Oe+k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357657},"main":"dist/index.js","gitHead":"14cb914938fbc702c6ca98f625f082e8656f51c2","scripts":{"dev":"tsc -w & node dist/index.js","mcp":"node mcp-cli.js","build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","prepack":"pnpm run build","rebuild":"pnpm run clean && pnpm run build","version":"echo $npm_package_version","postpack":"pnpm run clean","dev:build":"tsc && node dist/index.js","start:mcp":"node dist/index.js","dev:install":"pnpm run build && pnpm run install:global","install:global":"pnpm run build && npm install -g .","prepublishOnly":"pnpm run build","uninstall:global":"npm uninstall -g github-mcp-server"},"_npmUser":{"name":"giglepeople","email":"giglepeople@gmail.com"},"repository":{"url":"git+https://github.com/jungchihoon/github-mcp-server.git","type":"git"},"_npmVersion":"10.5.0","description":"A comprehensive Model Context Protocol (MCP) server that provides Git repository management capabilities for AI assistants and automation tools. Includes 29 Git operations + 11 workflow combinations with complete CLI alias system and advanced developer pr","directories":{},"_nodeVersion":"20.11.1","dependencies":{"zod":"^4.0.5","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.15.1","@modelcontextprotocol/inspector":"^0.16.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/github-mcp-server_1.8.5_1754045866933_0.3126286720035576","host":"s3://npm-registry-packages-npm-production"}},"1.8.6":{"name":"github-mcp-server","version":"1.8.6","keywords":["git","mcp","model-context-protocol","cli","github","workflow","automation","ai-assistant","git-tools","developer-tools"],"author":{"name":"Sharique Chaudhary"},"license":"ISC","_id":"github-mcp-server@1.8.6","maintainers":[{"name":"giglepeople","email":"giglepeople@gmail.com"}],"homepage":"https://github.com/jungchihoon/github-mcp-server#readme","bugs":{"url":"https://github.com/jungchihoon/github-mcp-server/issues"},"bin":{"gms":"mcp-cli.js","gadd":"mcp-cli.js","gdev":"mcp-cli.js","gfix":"mcp-cli.js","glog":"mcp-cli.js","gpop":"mcp-cli.js","gtag":"mcp-cli.js","gdiff":"mcp-cli.js","gflow":"mcp-cli.js","ginit":"mcp-cli.js","glist":"mcp-cli.js","gpull":"mcp-cli.js","gpush":"mcp-cli.js","gsave":"mcp-cli.js","gsync":"mcp-cli.js","gblame":"mcp-cli.js","gclean":"mcp-cli.js","gclone":"mcp-cli.js","gfresh":"mcp-cli.js","gmerge":"mcp-cli.js","gquick":"mcp-cli.js","greset":"mcp-cli.js","gstash":"mcp-cli.js","gbackup":"mcp-cli.js","gbisect":"mcp-cli.js","gbranch":"mcp-cli.js","gcherry":"mcp-cli.js","gcommit":"mcp-cli.js","grebase":"mcp-cli.js","gremote":"mcp-cli.js","gstatus":"mcp-cli.js","grelease":"mcp-cli.js","gcheckout":"mcp-cli.js","gworkflow":"mcp-cli.js","github-mcp-server":"mcp-cli.js","github-mcp-server-mcp":"dist/index.js"},"dist":{"shasum":"8cfdb190c527eb0392cfce47b717265b33f15e73","tarball":"https://registry.npmjs.org/github-mcp-server/-/github-mcp-server-1.8.6.tgz","fileCount":40,"integrity":"sha512-u3cFkFUjRxBVwLhU6uHl80TEsWFICam0AAB8QDs54XgdAsACCPhvwktjREsKirFjRiq4pj8Dr2j+UN7zgAmmtw==","signatures":[{"sig":"MEUCIQCCVwlFa2ZldyvZa43aFRA1ZcCRaswgTWmAe6Ud16P8LQIgeLlKWM+Otlf30f7TsdW9P0nTlMbJniaUd56w4ZSh8aw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357743},"main":"dist/index.js","gitHead":"9789a6574b8a5b97c56321ef9f2d3f96cc4c243e","scripts":{"dev":"tsc -w & node dist/index.js","mcp":"node mcp-cli.js","build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","prepack":"pnpm run build","rebuild":"pnpm run clean && pnpm run build","version":"echo $npm_package_version","postpack":"pnpm run clean","dev:build":"tsc && node dist/index.js","start:mcp":"node dist/index.js","mcp-server":"node dist/index.js","dev:install":"pnpm run build && pnpm run install:global","install:global":"pnpm run build && npm install -g .","prepublishOnly":"pnpm run build","uninstall:global":"npm uninstall -g github-mcp-server"},"_npmUser":{"name":"giglepeople","email":"giglepeople@gmail.com"},"repository":{"url":"git+https://github.com/jungchihoon/github-mcp-server.git","type":"git"},"_npmVersion":"10.5.0","description":"A comprehensive Model Context Protocol (MCP) server that provides Git repository management capabilities for AI assistants and automation tools. Includes 29 Git operations + 11 workflow combinations with complete CLI alias system and advanced developer pr","directories":{},"_nodeVersion":"20.11.1","dependencies":{"zod":"^4.0.5","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.15.1","@modelcontextprotocol/inspector":"^0.16.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/github-mcp-server_1.8.6_1754145293891_0.7146950778228145","host":"s3://npm-registry-packages-npm-production"}},"1.8.7":{"name":"github-mcp-server","version":"1.8.7","main":"dist/index.js","bin":{"github-mcp-server":"mcp-cli.js","github-mcp-server-mcp":"dist/index.js","gms":"mcp-cli.js","gstatus":"mcp-cli.js","gadd":"mcp-cli.js","gcommit":"mcp-cli.js","gpush":"mcp-cli.js","gpull":"mcp-cli.js","gbranch":"mcp-cli.js","gcheckout":"mcp-cli.js","glog":"mcp-cli.js","gdiff":"mcp-cli.js","gstash":"mcp-cli.js","gpop":"mcp-cli.js","greset":"mcp-cli.js","gclone":"mcp-cli.js","ginit":"mcp-cli.js","gremote":"mcp-cli.js","gflow":"mcp-cli.js","gquick":"mcp-cli.js","gsync":"mcp-cli.js","gdev":"mcp-cli.js","gworkflow":"mcp-cli.js","gfix":"mcp-cli.js","gfresh":"mcp-cli.js","gbackup":"mcp-cli.js","gclean":"mcp-cli.js","gsave":"mcp-cli.js","glist":"mcp-cli.js","grelease":"mcp-cli.js","gtag":"mcp-cli.js","gmerge":"mcp-cli.js","grebase":"mcp-cli.js","gcherry":"mcp-cli.js","gblame":"mcp-cli.js","gbisect":"mcp-cli.js"},"keywords":["git","mcp","model-context-protocol","cli","github","workflow","automation","ai-assistant","git-tools","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/jungchihoon/github-mcp-server.git"},"bugs":{"url":"https://github.com/jungchihoon/github-mcp-server/issues"},"homepage":"https://github.com/jungchihoon/github-mcp-server#readme","scripts":{"build":"tsc -p .","start":"node dist/index.js","dev":"tsc -w & node dist/index.js","dev:build":"tsc && node dist/index.js","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","clean":"rm -rf dist","rebuild":"pnpm run clean && pnpm run build","version":"echo $npm_package_version","mcp":"node mcp-cli.js","mcp-server":"node dist/index.js","install:global":"pnpm run build && npm install -g .","uninstall:global":"npm uninstall -g github-mcp-server","dev:install":"pnpm run build && pnpm run install:global","start:mcp":"node dist/index.js","prepublishOnly":"pnpm run build","prepack":"pnpm run build","postpack":"pnpm run clean"},"author":{"name":"Sharique Chaudhary"},"license":"ISC","description":"A comprehensive Model Context Protocol (MCP) server that provides Git repository management capabilities for AI assistants and automation tools. Includes 29 Git operations + 11 workflow combinations with complete CLI alias system and advanced developer pr","dependencies":{"@modelcontextprotocol/inspector":"^0.16.1","@modelcontextprotocol/sdk":"^1.15.1","express":"^5.1.0","zod":"^4.0.5"},"devDependencies":{"@types/node":"^24.0.14","typescript":"^5.8.3"},"_id":"github-mcp-server@1.8.7","gitHead":"eb49200325e7213386cedb438773609fcff000d6","_nodeVersion":"20.11.1","_npmVersion":"10.5.0","dist":{"integrity":"sha512-OftvcwNFattTRejZve+r8DOQGv4LfiJRW6jiDl4aQVWV+hvMseQmbcQ9Y+zF1+tm+EehcX3kBUl5t1yvBPKDbg==","shasum":"d7c96d13e2c94c93784b6199a1545a50b0c9a8e9","tarball":"https://registry.npmjs.org/github-mcp-server/-/github-mcp-server-1.8.7.tgz","fileCount":40,"unpackedSize":359934,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICwiuQsu5WyejKdkgpHGXAa2+6mNMqBP92SU9rqyhFCqAiEA5LjyF6123FGaj5OPztpsbzgbf+eEoCbHnNcnN3BVrIA="}]},"_npmUser":{"name":"giglepeople","email":"giglepeople@gmail.com"},"directories":{},"maintainers":[{"name":"giglepeople","email":"giglepeople@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/github-mcp-server_1.8.7_1754147288394_0.5118779199349364"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-01T10:52:28.062Z","modified":"2025-08-02T15:08:08.748Z","1.1.0":"2025-06-24T14:56:11.098Z","1.8.4":"2025-08-01T10:52:28.285Z","1.8.5":"2025-08-01T10:57:47.140Z","1.8.6":"2025-08-02T14:34:54.155Z","1.8.7":"2025-08-02T15:08:08.580Z"},"bugs":{"url":"https://github.com/jungchihoon/github-mcp-server/issues"},"author":{"name":"Sharique Chaudhary"},"license":"ISC","homepage":"https://github.com/jungchihoon/github-mcp-server#readme","keywords":["git","mcp","model-context-protocol","cli","github","workflow","automation","ai-assistant","git-tools","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/jungchihoon/github-mcp-server.git"},"description":"A comprehensive Model Context Protocol (MCP) server that provides Git repository management capabilities for AI assistants and automation tools. Includes 29 Git operations + 11 workflow combinations with complete CLI alias system and advanced developer pr","maintainers":[{"name":"giglepeople","email":"giglepeople@gmail.com"}],"readme":"# GitHub MCP Server\n🔗 **[View on MCP Market](https://mcpmarket.com/server/github-git-assistant)**\n<br />\n🔗 **[View on MCP Registry](https://mcp.so/server/github-mcp-server/Sharique%20Chaudhary)**\n\nA **Model Context Protocol (MCP) server** that provides **29 Git operations + 11 workflow combinations** for AI assistants and developers. This server exposes comprehensive Git repository management through a standardized interface, enabling AI models and developers to safely manage complex version control workflows.\n\n## 🎯 About\n\n**GitHub MCP Server** bridges AI assistants with Git repositories and provides powerful developer productivity tools. It provides:\n- **Safe Git operations** through a standardized MCP interface (29 operations)\n- **Complete version control** capabilities including advanced operations (tag, merge, rebase, cherry-pick, blame, bisect)\n- **31 workflow combinations** for enhanced developer productivity\n- **Advanced developer tools** (backup, cleanup, workflow automation)\n- **Error handling and validation** to prevent common Git mistakes\n- **Direct integration** with VS Code and AI assistants like GitHub Copilot\n- **CLI wrapper** for terminal access and automation\n\n## 🚀 Features Overview\n\nThis server provides comprehensive Git repository management through two main categories:\n\n### 📁 **Basic Git Operations** (17 operations)\nEssential daily Git commands organized in [`bin/basic/`](bin/basic/) - see **[Basic Operations Guide](bin/basic/README.md)** for detailed documentation.\n\n- **File Management**: Add, remove files from staging area\n- **Repository Information**: Status, history, differences\n- **Commit Operations**: Create commits, push, pull\n- **Branch Management**: Create, switch branches\n- **Remote Management**: Add, remove, configure remotes\n- **Stash Operations**: Temporarily save changes\n- **Reset Operations**: Repository state management\n\n### 🚀 **Advanced Git Operations** (12 operations) \nSophisticated workflows and automation in [`bin/advanced/`](bin/advanced/) - see **[Advanced Workflows Guide](bin/advanced/README.md)** for comprehensive documentation.\n\n- **Workflow Combinations**: Complete flows (add→commit→push), quick commits, sync operations\n- **Development Tools**: Smart development workflows, backup systems\n- **Advanced Git Features**: Tags, merging, rebasing, cherry-picking, blame, bisect\n- **Maintenance & Safety**: Repository cleanup, optimization, backup management\n- **Professional Workflows**: Release management, hotfix procedures, team collaboration\n\n## 🛠️ Installation\n\n### 🚀 Quick Start with npx (Recommended)\n\nThe fastest way to use GitHub MCP Server is with **npx** - no installation required!\n\n```bash\n# Basic Git operations\nnpx github-mcp-server gstatus\nnpx github-mcp-server gadd\nnpx github-mcp-server gcommit \"your commit message\"\nnpx github-mcp-server gpush\n\n# Advanced workflows\nnpx github-mcp-server gflow \"implement new feature\"\nnpx github-mcp-server gsync\nnpx github-mcp-server gbackup\n\n# Or use the short alias\nnpx gms gstatus\nnpx gms gflow \"quick fix\"\n```\n\n### 📦 Global Installation\n\nFor frequent use, install globally:\n\n```bash\n# Using npm\nnpm install -g github-mcp-server\n\n# Using pnpm (recommended)\npnpm add -g github-mcp-server\n\n# Then use directly\ngstatus\ngflow \"your message\"\ngsync\n```\n\n### 🔧 Local Development Installation\n\n**See [markdown/INSTALLATION.md](markdown/INSTALLATION.md)** for detailed installation guide for Windows, macOS, WSL, and all platforms.\n\n## 🤖 MCP Server Integration (Cursor, Claude, etc.)\n\n### 🎯 Cursor IDE에서 MCP 서버 사용하기\n\nCursor에서 GitHub MCP Server를 사용하려면 다음 설정을 추가하세요:\n\n**File**: `~/.cursor/mcp_config.json`\n\n#### 🔑 GitHub 토큰 설정 (권장)\n\nGitHub 토큰을 설정하면 인증 오류 없이 Git 작업을 수행할 수 있습니다:\n\n1. **GitHub Personal Access Token 생성**:\n   - GitHub.com → Settings → Developer settings → Personal access tokens → Tokens (classic)\n   - \"Generate new token\" → \"Generate new token (classic)\"\n   - 권한 설정: `repo`, `workflow`, `write:packages` 등 필요한 권한 선택\n   - 토큰 생성 후 안전한 곳에 저장\n\n2. **환경변수 설정**:\n   - `GITHUB_TOKEN`: GitHub Personal Access Token\n   - `GITHUB_USERNAME`: GitHub 사용자명 (선택사항, 기본값: 'git')\n\n```json\n{\n  \"mcpServers\": {\n    \"github-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"github-mcp-server-mcp\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your_github_personal_access_token\",\n        \"GITHUB_USERNAME\": \"your_github_username\"\n      },\n      \"capabilities\": [\"tools\", \"resources\", \"prompts\"]\n    }\n  }\n}\n```\n\n### 🔧 다른 MCP 클라이언트 설정\n\n#### Claude Desktop\n**File**: `~/.config/claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"github-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"github-mcp-server\", \"mcp\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n#### Continue (VS Code Extension)\n**File**: `~/.continue/config.json`\n\n```json\n{\n  \"models\": [\n    {\n      \"title\": \"GitHub MCP Assistant\",\n      \"provider\": \"anthropic\",\n      \"model\": \"claude-3-5-sonnet-20241022\",\n      \"contextLength\": 200000,\n      \"mcpServers\": [\n        {\n          \"name\": \"github-mcp-server\",\n          \"command\": \"npx\",\n          \"args\": [\"github-mcp-server\", \"mcp\"],\n          \"env\": {}\n        }\n      ]\n    }\n  ]\n}\n```\n\n### 🚀 MCP 서버 직접 실행\n\nnpm 패키지로 설치된 MCP 서버를 직접 실행할 수도 있습니다:\n\n```bash\n# 글로벌 설치 후\nnpm install -g github-mcp-server\ngithub-mcp-server mcp\n\n# 또는 npx로 직접 실행\nnpx github-mcp-server mcp\n```\n\n### 📋 사용 가능한 MCP 도구들\n\nMCP 서버를 통해 사용할 수 있는 29개 Git 작업:\n\n- **기본 작업**: git-status, git-add, git-commit, git-push, git-pull\n- **브랜치 관리**: git-branch, git-checkout, git-merge, git-rebase\n- **고급 작업**: git-tag, git-cherry-pick, git-blame, git-bisect\n- **워크플로우**: git-flow, git-sync, git-backup, git-clean\n\n**자세한 설정은 [markdown/MCP_UNIVERSAL_CONFIG.md](markdown/MCP_UNIVERSAL_CONFIG.md)**를 참조하세요.\n\n## 🚀 Quick Usage Guide\n\n### 📁 Basic Git Operations\n\n```bash\n# Check repository status\nnpx github-mcp-server gstatus\n\n# Add all files and commit\nnpx github-mcp-server gadd\nnpx github-mcp-server gcommit \"your commit message\"\n\n# Push to remote\nnpx github-mcp-server gpush\n\n# Pull from remote\nnpx github-mcp-server gpull\n\n# Branch operations\nnpx github-mcp-server gbranch feature-auth\nnpx github-mcp-server gcheckout feature-auth\n\n# View history and differences\nnpx github-mcp-server glog 5\nnpx github-mcp-server gdiff main\n```\n\n### 🚀 Advanced Workflows\n\n```bash\n# Complete workflow (add → commit → push)\nnpx github-mcp-server gflow \"implement new feature\"\n\n# Quick commit without push\nnpx github-mcp-server gquick \"fix typo\"\n\n# Sync with remote (pull → push)\nnpx github-mcp-server gsync\n\n# Development session management\nnpx github-mcp-server gdev feature-auth\n\n# Backup and safety\nnpx github-mcp-server gbackup --emergency\n\n# Repository cleanup\nnpx github-mcp-server gclean --optimize\n```\n\n### 🔧 Specialized Git Operations\n\n```bash\n# Tag management\nnpx github-mcp-server gtag create v1.0.0 \"Release version\"\n\n# Merge operations\nnpx github-mcp-server gmerge feature-branch\n\n# Rebase operations\nnpx github-mcp-server grebase main\n\n# Cherry-pick specific commit\nnpx github-mcp-server gcherry abc1234\n\n# Line-by-line authorship\nnpx github-mcp-server gblame src/app.js\n```\n\n### 📚 Help and Discovery\n\n```bash\n# List all available operations\nnpx github-mcp-server list\n\n# Get help for specific operation\nnpx github-mcp-server help\n\n# Show basic operations\nnpx github-mcp-server glist basic\n\n# Show advanced workflows\nnpx github-mcp-server glist advanced\n```\n\n## 🏗️ Project Structure & Architecture\n\n**GitHub MCP Server** is organized for clarity and progressive learning:\n\n```\ngithub-mcp-server/\n├── src/\n│   ├── index.ts              # MCP server (29 tool registrations, schema definitions)\n│   └── github.ts             # Git operations engine (all 29 implementations)\n├── bin/\n│   ├── basic/                # 📁 17 Essential Git Operations\n│   │   ├── README.md         # Comprehensive basic operations guide\n│   │   ├── gadd.js           # Add files (git add)\n│   │   ├── gcommit.js        # Create commits (git commit)\n│   │   ├── gpush.js          # Push changes (git push)\n│   │   ├── gpull.js          # Pull changes (git pull)\n│   │   ├── gstatus.js        # Repository status (git status)\n│   │   ├── gbranch.js        # Branch management (git branch)\n│   │   ├── gcheckout.js      # Branch switching (git checkout)\n│   │   ├── glog.js           # Commit history (git log)\n│   │   ├── gdiff.js          # Show differences (git diff)\n│   │   ├── gstash.js         # Stash operations (git stash)\n│   │   ├── gpop.js           # Apply stash (git stash pop)\n│   │   ├── greset.js         # Reset operations (git reset)\n│   │   ├── gclone.js         # Clone repositories (git clone)\n│   │   ├── gremote.js        # Remote management (git remote)\n│   │   └── ginit.js          # Initialize repository (git init)\n│   └── advanced/             # 🚀 13 Advanced Workflows & Automation\n│       ├── README.md         # Comprehensive advanced workflows guide\n│       ├── gflow.js          # Complete workflow (add→commit→push)\n│       ├── gquick.js         # Quick commit workflow\n│       ├── gsync.js          # Sync workflow (pull→push)\n│       ├── gdev.js           # Development session management\n│       ├── gworkflow.js      # Professional workflow combinations\n│       ├── gfix.js           # Smart fix and patch workflows\n│       ├── gfresh.js         # Fresh start workflows\n│       ├── gbackup.js        # Backup and safety operations\n│       ├── gclean.js         # Repository cleanup and optimization\n│       ├── gsave.js          # Save and preserve workflows\n│       ├── glist.js          # Tool discovery and help system\n│       ├── grelease.js       # Release management workflows\n│       └── common.js         # Shared utilities and helpers\n├── markdown/\n│   ├── INSTALLATION.md      # Detailed installation guide\n│   ├── DEPLOY.md            # Production deployment guide\n│   ├── DOCKER.md            # Docker setup and deployment guide\n│   └── QUICK_REFERENCES.md  # Copy-paste command reference\n├── mcp-cli.js               # Enhanced CLI wrapper (organized by structure)\n├── package.json             # Project configuration & npm scripts\n├── tsconfig.json            # TypeScript configuration\n└── README.md                # This comprehensive guide\n```\n\n## 📖 Documentation Structure\n\n- **[bin/basic/README.md](bin/basic/README.md)** - Complete guide to 17 essential Git operations\n- **[bin/advanced/README.md](bin/advanced/README.md)** - Comprehensive advanced workflows documentation  \n- **[markdown/INSTALLATION.md](markdown/INSTALLATION.md)** - Step-by-step installation for all platforms\n- **[markdown/MCP_UNIVERSAL_CONFIG.md](markdown/MCP_UNIVERSAL_CONFIG.md)** - Universal MCP configuration for all LLM clients\n- **[markdown/QUICK_REFERENCES.md](markdown/QUICK_REFERENCES.md)** - Copy-paste commands for quick reference\n- **[markdown/DOCKER.md](markdown/DOCKER.md)** - Docker setup, deployment, and containerization\n- **[markdown/DEPLOY.md](markdown/DEPLOY.md)** - Production deployment and hosting strategies\n\n## 🔧 Technical Architecture\n\n### 📡 **MCP Server Core** (src/index.ts)\n- **29 Tool Registrations** with complete JSON schemas\n- **Enhanced Metadata** with operation tracking and performance monitoring\n- **Input Validation** using Zod schemas for type safety\n- **Error Handling Pipeline** with timeout protection and meaningful messages\n- **Cross-platform Compatibility** with environment normalization\n\n### ⚙️ **Git Operations Engine** (src/github.ts)\n- **Comprehensive Implementation** of all 29 Git operations\n- **Security Features** - Command injection prevention and input sanitization\n- **Enhanced Error Handling** with context-aware messaging for common scenarios\n- **Performance Monitoring** - Operation duration tracking and logging\n- **Safety Checks** - Repository validation and file existence verification\n\n### 🖥️ **Enhanced CLI System**\n- **Smart Organization** - Tools categorized by basic vs advanced operations\n- **Directory-Aware Help** - References to specific README files for detailed guidance\n- **Progressive Learning** - Clear path from basic to advanced operations\n- **Tool Discovery** - Enhanced `glist` command with category filtering\n\n## 🛡️ Error Handling & Safety\n\n- **🔍 Repository Validation**: Ensures directory is a valid Git repository\n- **📁 File Existence Checks**: Validates files exist before Git operations\n- **⏱️ Timeout Protection**: 30-second timeout for operations\n- **🚫 Input Sanitization**: Prevents command injection\n- **📝 Detailed Error Messages**: Clear, actionable error descriptions\n\n## License\nISC License\n\n## Author\nCreated for use with AI assistants that support the Model Context Protocol.\n","readmeFilename":"README.md"}