github

Github MCP Server exposes a comprehensive Git operation surface via MCP. It includes 29 Git operations and 11 workflow combinations designed to empower AI assistants and developers to safely manage repositories and automate common version-control tasks. The server is organized into two main categories: Basic Git Operations (e.g., status, add, commit, push, pull, branch management, remote handling, stash, reset) and Advanced Git Operations (workflow-centric commands like complete add→commit→push flows, quick commits, sync operations, backups, and professional workflows). Users interact with the server through the MCP interface, invoking the registered tools and workflows using standardized schemas to ensure input validity and consistent results. The repository also provides a CLI wrapper and VS Code integration guidance for seamless developer experience.

Prerequisites:

• Node.js installed (for npx usage) or a Node-enabled environment
• Internet access to download the MCP server package

Install and run using one of these options:

Option 1 — MCP config file (recommended):

1. Create or update your MCP config file (e.g., .vscode/mcp.json) with: { "mcpServers": { "github-mcp-server": { "command": "npx", "args": ["-y", "@0xshariq/github-mcp-server@latest"] } } }

2. Start using your MCP client that reads the config (depends on your setup).

Option 2 — Global CLI installation (CLI):

1. Install the server globally via PNPM:

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

2. Test commands provided after installation, for example:

gstatus
ngadd
glog 10
gpush

Option 3 — Symbolic links (no package manager):

1. Clone the repository and install/build:

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

2. Create symbolic links as needed (user or system-wide) using the provided setup script, then test with commands like:

gstatus
 glist

Note: If you encounter issues such as command not found or path conflicts, consult the Troubleshooting guide at the linked repository (markdown/TROUBLESHOOTING.md) for common resolutions.

Tips and considerations:

• The server provides a robust 29-tool operation surface with enhanced validation via Zod schemas to prevent invalid inputs.
• It includes 31 workflow combinations and advanced tooling for backup, cleanup, and automation, making it suitable for AI-assisted development pipelines.
• Look for the complete installation and deployment guidance in the project’s markdown folder (markdown/INSTALLATION.md, DOCKER.md, DEPLOY.md).
• If integrating with IDEs like VS Code or AI assistants (e.g., GitHub Copilot), ensure environment paths and CLI wrappers are correctly configured to avoid conflicts.
• For production deployments, consider using the docker deployment guide and MCP universal config to ensure compatibility across clients.