Provides tools for GitHub operations including repository cloning, branching, committing, pushing, creating pull requests, and managing issues via git and gh CLI.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@github-mcp create a pull request in owner/repo from feature to main"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server for GitHub operations. Provides high-level, verified GitHub workflows via git/gh CLI.
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
npm install @dragons-claw/mcp-githubOr run directly:
npx @dragons-claw/mcp-githubNode.js 18+
Git CLI installed and configured
GitHub CLI (gh) installed and authenticated (gh auth login)
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"]
}
}
}# 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"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);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 |
Variable | Description | Default |
| Default workspace directory | Current directory |
| Enable debug logging |
|
MIT
See SKILLS.md for workflow documentation and best practices.
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
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
