amotarao/amon-github-mcp-server

my-github-mcp-server

A GitHub MCP (Model Context Protocol) server implementation that provides tools for interacting with GitHub repositories, issues, pull requests, and user information.

Features

This MCP server provides the following tools:

• get_parent_of_sub_issue: Get the parent issue of a sub-issue using GitHub Sub-Issues API
• list_sub_issues: List sub-issues for a GitHub issue with pagination and filtering support
• get_id_of_issue: Get the internal GitHub issue ID from an issue number
• get_ids_of_issues: Get the internal GitHub issue IDs from multiple issue numbers with batch processing support
• add_sub_issues: Add multiple sub-issues to a GitHub issue using GitHub Sub-Issues API with batch processing support
• remove_sub_issues: Remove multiple sub-issues from a GitHub issue using GitHub Sub-Issues API with batch processing support
• set_milestone_for_issues: Set milestone for multiple GitHub issues with batch processing support

Installation

pnpm install
pnpm build

Usage

Local Development

pnpm dev

Production

pnpm start

Configuration

The server supports optional GitHub API authentication via environment variables:

• GITHUB_PERSONAL_ACCESS_TOKEN: GitHub personal access token for authenticated requests (optional, but recommended for higher rate limits)

MCP Integration

Claude Desktop Configuration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/claude/claude_desktop_config.json

Server URLs

• Production: https://amon-github-mcp-server.vercel.app/mcp
• Local Development: http://localhost:3000/mcp

Configuration

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "SERVER_URL_HERE",
      "headers": {
        "X-GITHUB-TOKEN": "your_github_personal_access_token_here"
      }
    }
  }
}

Replace SERVER_URL_HERE with the appropriate URL from the Server URLs section above.

Authentication

The server reads the GitHub token from the X-GITHUB-TOKEN header in HTTP requests. The token should be provided as the raw token value without any prefix.

Without a token, the server works with GitHub's public API with standard rate limits.

Deployment

This server is configured for deployment on Vercel. The vercel.json configuration file is included.