trackmcp
Back to directory
md-anbari

cursor-mcp-guide

View on GitHub

A comprehensive guide to setting up and using MCP server with Cursor IDE, including GitHub integration and AI agent configuration.

2 starsAI & Machine Learning Updated Apr 30, 2025

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:

    3. Run the installer and follow the prompts

    Installing GitHub MCP

    bash
    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:

    json
    {
      "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:

      3. Select "GitHub MCP" from the list

      4. Follow installation instructions

      Adding to Cursor

      Method 1: Command Line Installation

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

      Method 2: Manual Configuration

      1. Open Cursor Settings:

        2. Add MCP Server:

          Method 3: Direct JSON Configuration

          1. Navigate to `~/.cursor/mcp.json`

          2. Add server configuration manually:

          json
          {
            "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

          Frequently asked questions

          What is cursor-mcp-guide?

          cursor-mcp-guide is A comprehensive guide to setting up and using MCP server with Cursor IDE, including GitHub integration and AI agent configuration.

          How do I install cursor-mcp-guide?

          Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

          Is cursor-mcp-guide open source?

          Yes — it is hosted on GitHub at https://github.com/md-anbari/cursor-mcp-guide and has 2 stars.

          Related MCP tools

          Run your own MCP server? See who uses it and what to fix.

          Measure it with TrackMCP