MCP_server_cursor_to_github

MCP_server_cursor_to_github

3.2

If you are the rightful owner of MCP_server_cursor_to_github and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a comprehensive guide on setting up a Model Context Protocol (MCP) server for GitHub control using the Cursor editor.


title: Connect Cursor to MCP for GitHub Control

🔄 MCP + Cursor GitHub Setup

Set up full GitHub control via Cursor once your MCP server is running.

🛠️ Step-by-Step Cursor Setup for MCP

🧭 1. Open Cursor Editor

  • Launch Cursor, the AI-first code editor.
  • Click Settings (bottom-left corner ⚙️).

🌐 2. Navigate to MCP Section

  • In Settings, scroll down to the MCP (Model Context Protocol) section.
  • Click "Add Server".

🔧 3. Fill in MCP Server Details

  • Name: Local MCP Server
  • URL: http://localhost:3333 (or your configured port from server.js)
  • Client: Select ollama or your preferred LLM engine.
  • Auth: Leave blank for local use (behind firewall). Add headers if using token-based auth.

✅ Cursor is now connected to your MCP server!

⚙️ Make Sure Your MCP Server Is Running

Run your server locally from your terminal:

node server.js

Expected output:

✅ MCP server running at http://localhost:3333

🤖 Use Cursor Prompts to Control GitHub

With MCP connected, use the Cursor command palette:

⌘ + K / Ctrl + K → Type:

Create a private GitHub repo named ai-lab
Add README.md to ai-lab repo with initial text
Search repositories about 'android hacking tools'

MCP GitHub plugin (@smithery-ai/github) handles GitHub API calls via your server.

✅ Available GitHub Tools via MCP

ToolDescription
create_or_update_fileCreate or update files
create_repositoryCreate a new GitHub repository
delete_repositoryDelete a repository (if supported)
get_file_contentsRead contents of files
search_repositoriesDiscover GitHub repositories

These tools can be triggered through Cursor's prompt bar or:

npx @smithery/cli

🧠 Best Practice Tips

  • Keep your mcp.json secure (especially GitHub tokens).
  • Use environment variables for secrets in production.
  • Test server connection with:
curl http://localhost:3333

Logs will show tool calls and API responses for easier debugging.


title: "MCP Server + GitHub Cursor Setup Guide" description: "Step-by-step guide for setting up MCP server with Cursor GitHub integration for repo automation, creation, deletion, and commit control."

🚀 MCP Server + GitHub Cursor Integration

This tutorial walks you through setting up MCP with GitHub using Cursor and controlling repositories from the terminal or automation workflows.

📦 Prerequisites

  • Node.js & npm installed
  • Cursor CLI downloaded for your OS
  • A GitHub account
  • An MCP-compatible agent setup with @modelcontextprotocol/sdk

🔐 Step 1: Create a GitHub Personal Access Token

  1. Go to GitHub Developer Settings
  2. Click "Fine-grained tokens" → Generate new token
  3. Set:
    • Name: just_think
    • Expiration: May 18, 2025 (or your preferred)
    • Permissions:
      • Repositories: Full Read/Write
      • User: Full Read/Write
  4. Copy the token now. You will not see it again!
github_pat_11A4PP7FQ07lGRHVynbe5e_... (keep it secret!)

⚙️ Step 2: Configure mcp.json

{
  "defaultClient": "ollama",
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "model": "llama2"
  },
  "github": {
    "token": "<your_copied_github_token>"
  },
  "agent": {
    "name": "DevOpsAgent",
    "persona": "An automation assistant for GitHub repo management"
  }
}

Save it as mcp.json in your project folder.


💻 Step 3: Run the MCP Studio Server

// server.js
import { studio } from '@modelcontextprotocol/sdk/server/studio.js';

studio.run({
  config: './mcp.json',
  port: 3333
});

Then run:

node server.js

🧠 Step 4: Connect Cursor to GitHub

npx -y @smithery/cli@latest install @smithery-ai/github --client claude --config mcp.json

This will install the GitHub Cursor adapter and register the token from mcp.json.


🔧 Step 5: Automate Repo Control via Cursor

Use the terminal to create, delete, or manage GitHub repos:

✅ Create a Repository

npx @smithery/cli ask "Create a new private repo called test-automation"

❌ Delete a Repository

npx @smithery/cli ask "Delete the repo named old-project"

📥 Commit Code

npx @smithery/cli ask "Commit all changes to the repo my-app with message 'Init commit'"

📚 Use Cases

  • 🚀 CI/CD Pipelines – Deploy workflows via GitHub Actions
  • 🧠 LLM Automation – Agents can trigger repo events
  • 🛡 Secure DevOps – Use fine-grained tokens to maintain security
  • 🧰 Full Dev Automation – No manual clicking, fully terminal-driven

📎 Resources


If you'd like a complete ready-to-clone repo with these files, just ask and I’ll generate one!