Provides natural language command suggestions and explanations for Git operations through GitHub Copilot CLI integration.
Enables natural language command suggestions and explanations for GitHub CLI operations like creating pull requests and managing issues through GitHub Copilot CLI integration.
Wraps GitHub Copilot CLI to provide command suggestions from natural language, command explanations, shell alias generation, and configuration management for shell, Git, and GitHub CLI commands.
GitHub Copilot CLI MCP Server
An MCP (Model Context Protocol) server that wraps the GitHub Copilot CLI (gh copilot), enabling AI assistants to interact with GitHub Copilot through a standardized interface.
Features
Command Suggestions: Get shell, git, and GitHub CLI command suggestions from natural language
Command Explanations: Understand what complex commands do
Shell Aliases: Generate convenience aliases for your shell
Configuration: View and manage Copilot CLI settings
Dual Transport Support: Both STDIO (local) and SSE (network) transports
Prerequisites
Python 3.10+
GitHub CLI (
gh) installed: https://cli.github.com/GitHub Copilot extension for gh:
gh extension install github/gh-copilotGitHub Copilot subscription (Individual, Business, or Enterprise)
Installation
Option 1: Install from source
Option 2: Install with pip
Usage
STDIO Transport (Local)
For local MCP client connections:
SSE Transport (Network)
For network-accessible MCP server:
Or with custom host/port:
Available Tools
copilot_suggest
Get a command suggestion from GitHub Copilot based on natural language.
Parameters:
prompt(required): Natural language description of what you want to dotarget: Target type -'shell'(default),'gh', or'git'
Examples:
copilot_suggest_shell
Convenience wrapper for shell command suggestions.
Parameters:
prompt(required): Natural language description
Examples:
"Kill processes holding onto deleted files"
"Convert SVG to PNG and resize"
copilot_suggest_git
Convenience wrapper for git command suggestions.
Parameters:
prompt(required): Natural language description
Examples:
"Undo the most recent local commits"
"Clean up local branches"
copilot_suggest_gh
Convenience wrapper for GitHub CLI command suggestions.
Parameters:
prompt(required): Natural language description
Examples:
"Create pull request"
"List pull requests waiting for my review"
copilot_explain
Get an explanation of a command from GitHub Copilot.
Parameters:
command(required): The command to explain
Examples:
copilot_version
Get the GitHub Copilot CLI version information.
copilot_help
Get help information.
Parameters:
command: Optional command to get help for ('suggest', 'explain', 'config', 'alias')
copilot_config_get
Get GitHub Copilot CLI configuration.
Parameters:
key: Optional specific config key (empty shows all)
copilot_alias
Generate shell aliases for convenience commands.
Parameters:
shell: Shell type -'bash','zsh','fish', or'powershell'
MCP Client Configuration
Claude Code / Claude Desktop
Add to your MCP settings:
SSE Client Configuration
Environment Variables
Variable | Default | Description |
|
| SSE server bind address |
|
| SSE server port |
Examples
Get a Shell Command Suggestion
Explain a Complex Command
Get Git Help
Get GitHub CLI Help
Systemd Service (Optional)
Create /etc/systemd/user/copilot-mcp.service:
Enable and start:
License
MIT License
Related Projects
Claude Code MCP Server - Similar MCP wrapper for Claude Code CLI
Gemini CLI MCP Server - Similar MCP wrapper for Gemini CLI