GitHub MCP Server

A Model Context Protocol (MCP) server that exposes GitHub issues, pull requests, and Actions workflows as tools for AI assistants.

Built with TypeScript, Express, and the MCP SDK. Uses SSE transport so it can be connected from Cursor or other MCP clients over HTTP.

Features

Issues

Pull Requests

GitHub Actions

Related MCP server: github-mcp

Prerequisites

• Node.js 22+

• pnpm

• A GitHub personal access token

Setup

1. Clone the repository and install dependencies:

pnpm install

2. Copy the environment template and add your GitHub token:

cp .env.example .env

Edit .env and set GITHUB_TOKEN to your personal access token.

3. Build the project:

pnpm build

Development

Start the server in watch mode:

pnpm dev

The server listens on port 8080 and exposes:

• GET /sse — SSE endpoint for MCP client connections

• POST /messages — Message endpoint for MCP transport

Project Structure

src/
├── main.ts                 # MCP server entry point (SSE transport)
├── tools/
│   ├── index.ts            # Registers all MCP tools
│   ├── issues.ts           # Issue tools
│   ├── pull-requests.ts    # Pull request tools
│   └── actions.ts          # GitHub Actions tools
└── github-functions/
    ├── client.ts           # Shared Octokit client
    ├── types.ts            # Shared types
    ├── issues.ts           # Issue API wrappers
    ├── pull-requests.ts    # Pull request API wrappers
    └── actions.ts          # Actions API wrappers

Scripts

License

MIT