github-mcp
Provides tools for GitHub operations including repository cloning, branching, committing, pushing, creating pull requests, and managing issues via git and gh CLI.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@dragons-claw/mcp-github
A Model Context Protocol (MCP) server for GitHub operations. Provides high-level, verified GitHub workflows via git/gh CLI.
Features
Clone & Branch: Clone repositories and create feature branches
Full Contribution: Complete PR workflow in one command (clone → branch → edit → commit → push → PR)
Issue Management: Create issues with duplicate checking
PR Management: Create PRs with branch verification
Commit & Push: Stage, commit, and push changes
Workspace Cleanup: Remove cloned repositories
All operations include:
Step-by-step verification
Windows/PowerShell compatibility
Intelligent stderr handling (git/gh write progress to stderr)
Existing resource detection (reuse clones, skip existing PRs)
Related MCP server: mcp-server-github
Installation
npm install @dragons-claw/mcp-githubOr run directly:
npx @dragons-claw/mcp-githubRequirements
Node.js 18+
Git CLI installed and configured
GitHub CLI (
gh) installed and authenticated (gh auth login)
Usage
As MCP Server (stdio mode)
For integration with MCP clients like Claude Desktop:
mcp-github --stdio --workspace /path/to/workspaceAdd to Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["@dragons-claw/mcp-github", "--stdio", "--workspace", "/path/to/workspace"]
}
}
}As CLI Tool
# List all available tools
mcp-github
# Clone and create branch
mcp-github --tool github_clone_and_branch \
--repo owner/repo \
--branch feature-name
# Full contribution workflow
mcp-github --tool github_full_contribution \
--repo owner/repo \
--branch feature-name \
--filePath src/new-file.ts \
--fileContent "console.log('hello');" \
--commitMessage "Add new file" \
--prTitle "Add new feature"
# Create issue
mcp-github --tool github_create_issue \
--repo owner/repo \
--title "Bug report" \
--body "Description of the issue"As Library
import { MCPGitHubServer, initMCPGitHubServer } from '@dragons-claw/mcp-github';
const server = initMCPGitHubServer({
workspacePath: '/path/to/workspace',
});
await server.start();
// Execute a tool
const result = await server.executeTool('github_clone_and_branch', {
repo: 'owner/repo',
branch: 'feature-name',
});
console.log(result.success ? result.content : result.error);Available Tools
Tool | Description |
| Clone a repo and create/checkout a branch |
| Complete PR workflow: clone, branch, edit, commit, push, create PR |
| Create a GitHub issue |
| Create a pull request (requires branch pushed first) |
| Stage, commit, and push changes |
| Get status of a task checklist |
| List all in-progress tasks |
| Remove a cloned repository |
Environment Variables
Variable | Description | Default |
| Default workspace directory | Current directory |
| Enable debug logging |
|
License
MIT
Contributing
See SKILLS.md for workflow documentation and best practices.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Manage repositories, users, releases, and automate GitHub workflows
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive interaction with GitHub repositories, including code management, issues, pull requests, and full GitHub Actions workflow control with triggering, monitoring, and artifact management capabilities.475 npm-
- AlicenseAqualityDmaintenanceEnables interaction with GitHub repositories, issues, pull requests, code search, branches, and GitHub Actions workflows.816 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive GitHub operations including repository management, push, releases, issues, PRs, GitHub Actions, secrets, security, profile, search, and a unique portfolio push tool to create repos from local folders.MIT
- AlicenseNot gradedqualityDmaintenanceEnables to interact with GitHub repositories directly from Claude, supporting actions like viewing repos, checking status, committing and pushing changes, and managing pull requests.544 npmMIT