Skip to content

WARP_MCP_SETUP.md

Latest commit

 

History

History
135 lines (105 loc) · 3.11 KB

WARP_MCP_SETUP.md

File metadata and controls

135 lines (105 loc) · 3.11 KB
Raw

Setting Up GitHub MCP Server in Warp

Quick Setup Instructions

1. Copy Your GitHub Token

gh auth token

Copy the output (your personal access token).

2. Add MCP Server in Warp

  1. Open Warp MCP Settings

    • Method 1: Cmd+P → type "MCP" → select "Open MCP Servers"
    • Method 2: Settings → AI → Manage MCP servers
    • Method 3: Warp Drive → Personal → MCP Servers

  2. Add GitHub Server

    • Click "+ Add" button
    • Choose "CLI Server (Command)"
    • Fill in the configuration:

Configuration Details:

  • Server Name: GitHub
  • Command: docker
  • Args (one per line): 
    run
-i
--rm
-e
GITHUB_PERSONAL_ACCESS_TOKEN
ghcr.io/github/github-mcp-server
  • Environment Variables: 
    {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "PASTE_YOUR_TOKEN_HERE"
}
  1. Save and Start
    • Click "Save"
    • Click the "Start" button next to your GitHub server
    • Wait for green "Running" status

3. Test the Integration

Once the server is running, you can use natural language in Warp terminal:

Repository Operations

"Show me information about this repository"
"List my recent repositories"  
"What's the primary language of this repo?"

Issue Management

"Show me open issues in this repository"
"Create an issue for the email validation bug"
"List issues labeled as bug"

Code and Commits

"Show me recent commits"
"What files were changed in the last commit?"
"Search for TODO comments in this repository"

Troubleshooting

Server Won't Start

  • Ensure Docker is running
  • Verify your GitHub token has correct permissions (repo, user scopes)
  • Check the server logs in MCP settings

Limited Functionality

  • Make sure you're in a Git repository directory
  • Verify the repository exists on GitHub
  • Check that your token has access to the repository

Token Permissions Required

Your GitHub token should have these scopes:

  • repo - Full repository access
  • user - User profile access
  • project - Project access (optional)
  • workflow - Actions access (optional)

Available GitHub Operations

With the MCP server running, you can:

✅ Repository Management

  • View repository details and statistics
  • List branches, tags, and releases
  • Browse file contents

✅ Issue & PR Management

  • Create, update, and close issues
  • List and search issues/PRs
  • Add comments and labels

✅ Code Analysis

  • Search code across repositories
  • View commit history and diffs
  • Analyze file changes

✅ Workflow Operations

  • View GitHub Actions runs
  • Check workflow status
  • Download artifacts

What Makes This Powerful

Instead of switching between terminal and browser:

Before:

  1. Terminal → write code
  2. Browser → create GitHub issue
  3. Browser → assign labels
  4. Browser → check status

After with MCP:

"Analyze this code and create a GitHub issue for any bugs found"

Result: Automatic code analysis + structured GitHub issue creation with appropriate labels and descriptions!

Next: Try the natural language commands above in your Warp terminal once the MCP server is running.