Peterparker57 Github MCP Server

🚀 GitHub MCP Server

A Model Context Protocol (MCP) server that provides GitHub integration features. This server interacts with GitHub repositories through MCP tools, supporting functions such as repository management, file operations, and commit processing.

✨ Features

• Account management and authentication
• Repository creation and management
• File operations (read, write, push, pull)
• Commit operations
• Directory synchronization
• Repository comparison and difference analysis

📦 Installation

npm install @modelcontextprotocol/server-github

🛠 Configuration

Add the server to the MCP settings file (cline_mcp_settings.json):

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN_1": "your-github-token",
        "GITHUB_OWNER_1": "your-github-username"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

💻 Usage Examples

Available Tools

Account Management

list_accounts

List the available GitHub accounts configured in the server.

select_account

Select a GitHub account for subsequent operations.

Repository Management

create_repository

Create a new GitHub repository.

{
  owner?: string;        // Repository owner (optional if an account is selected)
  name: string;          // Repository name
  description: string;   // Repository description
  private?: boolean;     // Whether it is a private repository
}

clone_repository

Clone a GitHub repository to a local directory.

{
  owner?: string;    // Repository owner
  repo: string;      // Repository name
  branch?: string;   // Branch name (default: main)
  outputDir: string; // Local target directory for cloning
}

rename_repository

Rename an existing GitHub repository.

{
  owner?: string;    // Repository owner
  repo: string;      // Current repository name
  new_name: string;  // New repository name
}

File Operations

push_file

Push a file to a GitHub repository.

{
  owner?: string;     // Repository owner
  repo: string;       // Repository name
  path: string;       // Target path in the repository
  message: string;    // Commit message
  sourcePath: string; // Local file path to be pushed
}

pull_file

Pull a file from a GitHub repository.

{
  owner?: string;     // Repository owner
  repo: string;       // Repository name
  path: string;       // File path in the repository
  outputPath: string; // Local path to save the file
}

sync_directory

Perform two - way synchronization between local and remote directories.

{
  owner?: string;    // Repository owner
  repo: string;      // Repository name
  path: string;      // Target path in the repository
  outputDir: string; // Local target directory for synchronization
}

Commit Operations

create_commit

Create a new commit in the repository.

{
  owner?: string;       // Repository owner
  repo: string;         // Repository name
  branch: string;       // Branch name
  message: string;      // Commit message
  author_name: string;  // Name of the commit author
  author_email: string; // Email of the commit author
}

Development

npm run dev

Environment Variables

• GITHUB_TOKEN_1: Access token for GitHub account 1.
• GITHUB_OWNER_1: Owner name of GitHub account 1.
• Other environment variables can be extended as needed.

📄 License

[Insert license information here]