A comprehensive guide to setting up and using MCP server with Cursor IDE, including GitHub integration and AI agent configuration.
Documentation
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/githubMethod 2: Manual Configuration
1. Open Cursor Settings:
- Use
⌘ + Shift + P(macOS) orCtrl + 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
Similar MCP
Based on tags & features
Trending MCP
Most active this week