cursor-mcp-guide

Understanding MCP (Model Context Protocol) and GitHub Integration

What is MCP?

Model Context Protocol (MCP) is a revolutionary standardized protocol that enables AI agents to communicate seamlessly with various tools and services. Think of it like a universal translator:

• Without MCP: Each tool speaks its own language, making it difficult for AI agents to integrate with multiple tools.
• With MCP: All tools speak the same language, allowing easy integration and communication.

Real-World Analogy

Imagine having ten expert consultants, each speaking a different language:

• Without MCP: You'd need ten different translators
• With MCP: Everyone speaks a common language, making collaboration effortless

This standardization allows AI agents to:

• Connect to databases
• Interact with GitHub
• Access cloud services
• Manage files and documents
• And much more!

GitHub MCP Features

The GitHub MCP integration provides powerful capabilities for interacting with GitHub repositories:

Repository Management

• Create new repositories
• Fork existing repositories
• Clone repositories
• Manage branches
• Create and merge pull requests

Code Operations

• Search through code
• Create and edit files
• Commit changes
• Review pull requests
• Add comments and reviews

Issue Management

• Create and update issues
• Add comments to issues
• Search through issues
• Apply labels and assignees
• Track milestones

Collaboration Features

• Manage project boards
• Handle discussions
• Review comments
• Manage repository settings
• Control access permissions

Installation Guide

Prerequisites: Node.js Setup

1. Visit Node.js website
2. Download the appropriate version:
   • For M1/M2 Macs: macOS ARM64
   • For Intel Macs: macOS x64
3. Run the installer and follow the prompts

Installing GitHub MCP

Method 1: Using Smithery CLI (Recommended)

npx -y @smithery/cli@latest install @smithery-ai/github \
  --client cursor \
  --config '{"githubPersonalAccessToken":"your_token_here"}'

Method 2: Manual Configuration

1. Open ~/.cursor/mcp.json
2. Add the following configuration:

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

Finding MCP Servers on Smithery

1. Visit Smithery
2. Browse available MCP servers:
   • Filter by category
   • Sort by popularity
   • Search by name or functionality
3. Select "GitHub MCP" from the list
4. Follow installation instructions

Adding to Cursor

Method 1: Command Line Installation

# Using Smithery CLI
npx @smithery/cli install @smithery-ai/github

Method 2: Manual Configuration

1. Open Cursor Settings:

   • Use ⌘ + Shift + P (macOS) or Ctrl + Shift + P (Windows)
   • Type "Cursor Settings"
   • Select "MCP"

2. Add MCP Server:

   • Click "Add new global MCP server"
   • Configure using the provided JSON structure

Method 3: Direct JSON Configuration

1. Navigate to ~/.cursor/mcp.json
2. Add server configuration manually:

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

Using GitHub MCP

Once installed, you can use GitHub MCP to:

1. Create and manage repositories
2. Handle issues and pull requests
3. Search through code
4. Manage files and branches
5. Collaborate with team members