Skip to main content
Glama
deenesjakoruzh

GitHub Enterprise MCP Server

by ddukbg
npmGitHub
TypeScript
449
21
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

GitHub Enterprise MCP Server

image

An MCP (Model Context Protocol) server for integration with GitHub Enterprise API. This server provides an MCP interface to easily access repository information, issues, PRs, and more from GitHub Enterprise in Cursor.

Compatibility

This project is primarily designed for GitHub Enterprise Server environments, but it also works with:

  • GitHub.com
  • GitHub Enterprise Cloud

Note: Some enterprise-specific features (like license information and enterprise statistics) will not work with GitHub.com or GitHub Enterprise Cloud.

Key Features

  • Retrieve repository list from GitHub Enterprise instances
  • Get detailed repository information
  • List repository branches
  • View file and directory contents
  • Manage issues and pull requests
  • Repository management (create, update, delete)
  • GitHub Actions workflows management
  • User management (list, create, update, delete, suspend/unsuspend users)
  • Access enterprise statistics
  • Enhanced error handling and user-friendly response formatting

Getting Started

Prerequisites

  • Node.js 18 or higher
  • Access to a GitHub Enterprise instance
  • Personal Access Token (PAT)

Docker Installation and Setup

Option 1: Running with Docker
  1. Build the Docker image:
    docker build -t github-enterprise-mcp .
  2. Run the Docker container with environment variables:
    docker run -p 3000:3000 \ -e GITHUB_TOKEN="your_github_token" \ -e GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" \ -e DEBUG=true \ github-enterprise-mcp

Note: The Dockerfile is configured to run with --transport http by default. If you need to change this, you can override the command:

docker run -p 3000:3000 \ -e GITHUB_TOKEN="your_github_token" \ -e GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" \ -e DEBUG=true \ github-enterprise-mcp node dist/index.js --transport http --debug
Option 2: Using Docker Compose
  1. Create a .env file in the project root with the required environment variables:
    GITHUB_ENTERPRISE_URL=https://github.your-company.com/api/v3 GITHUB_TOKEN=your_github_token DEBUG=true
  2. Start the container with Docker Compose:
    docker-compose up -d
  3. Check the logs:
    docker-compose logs -f
  4. Stop the container:
    docker-compose down

Installation and Setup

Local Development (Using Concurrent Mode)

This method is recommended for active development with automatic recompilation and server restarts:

  1. Clone the repository and install required packages:
    git clone https://github.com/ddukbg/github-enterprise-mcp.git cd github-enterprise-mcp npm install
  2. Run the development server:
    export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" npm run dev
    This will:
    • Compile TypeScript code automatically when files change
    • Restart the server when compiled files are updated
    • Run the server in HTTP mode for URL-based connections
  3. Connect to Cursor using URL mode as described below

Installation and Setup for Production

This method is the most stable and recommended for local development or testing:

  1. Clone the repository and install required packages:
    git clone https://github.com/ddukbg/github-enterprise-mcp.git cd github-enterprise-mcp npm install
  2. Build the project:
    npm run build chmod +x dist/index.js
  3. Run the server:
    export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" node dist/index.js --transport http --debug
  4. Connect to Cursor using URL mode:
    • Add the following to your Cursor's .cursor/mcp.json file:
    { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse" } } }

This method is useful for local development:

# After cloning the repository git clone https://github.com/ddukbg/github-enterprise-mcp.git cd github-enterprise-mcp # Install required packages npm install # Build npm run build chmod +x dist/index.js # Link globally npm link # Run as a global command export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" github-enterprise-mcp --transport=http --debug
Option 3: Using npx (When Package is Published)

If the package is published to the public npm registry:

npx @ddukbg/github-enterprise-mcp --token=your_github_token --github-enterprise-url=https://github.your-company.com/api/v3

Integration with AI Tools

Claude Desktop

Add the following to your claude_desktop_config.json:

{ "mcpServers": { "github-enterprise": { "command": "npx", "args": ["-y", "@ddukbg/github-enterprise-mcp", "--token=YOUR_GITHUB_TOKEN", "--github-enterprise-url=YOUR_GITHUB_ENTERPRISE_URL"] } } }

Replace YOUR_GITHUB_TOKEN and YOUR_GITHUB_ENTERPRISE_URL with your actual values.

Cursor

For the most reliable operation in Cursor, using URL mode is recommended:

  1. Start the server in a separate terminal window:
    cd /path/to/github-enterprise-mcp GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" GITHUB_TOKEN="your_github_token" node dist/index.js --transport http
  2. Configure Cursor's MCP settings:
    • Open Cursor and go to Settings
    • Navigate to AI > MCP Servers
    • Edit your .cursor/mcp.json file:
    { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse" } } }
  3. Restart Cursor to apply the changes
Alternative: Command Mode

Alternatively, you can configure Cursor to use the command mode, although URL mode is more reliable:

  1. Open Cursor and go to Settings
  2. Navigate to AI > MCP Servers
  3. Click Add MCP Server
  4. Enter the following details:
    • Name: GitHub Enterprise
    • Command: npx
    • Arguments: @ddukbg/github-enterprise-mcp
    • Environment Variables:
      • GITHUB_ENTERPRISE_URL: Your GitHub Enterprise API URL
      • GITHUB_TOKEN: Your GitHub personal access token

Alternatively, you can manually edit your .cursor/mcp.json file to include:

{ "mcpServers": { "github-enterprise": { "command": "npx", "args": [ "@ddukbg/github-enterprise-mcp" ], "env": { "GITHUB_ENTERPRISE_URL": "https://github.your-company.com/api/v3", "GITHUB_TOKEN": "your_github_token" } } } }

Language Configuration

This MCP server supports both English and Korean languages. You can configure the language using:

Environment Variables

# Set language to Korean export LANGUAGE=ko # Or in .env file LANGUAGE=ko

Command-line Arguments

# Set language to Korean node dist/index.js --language ko

The default language is English if not specified.

Additional Options in HTTP Mode

  • --debug: Enable debug logging
  • --github-enterprise-url <URL>: Set GitHub Enterprise API URL
  • --token <TOKEN>: Set GitHub Personal Access Token
  • --language <LANG>: Set language (en or ko, default: en)

Available MCP Tools

This MCP server provides the following tools:

Tool NameDescriptionParametersRequired PAT Permissions
list-repositoriesRetrieve repository list for a user or organizationowner: Username/org nameisOrg: Whether it's an organizationtype: Repository typesort: Sort criteriapage: Page numberperPage: Items per pagerepo
get-repositoryGet detailed repository informationowner: Repository ownerrepo: Repository namerepo
list-branchesList branches of a repositoryowner: Repository ownerrepo: Repository nameprotected_only: Whether to show only protected branchespage: Page numberperPage: Items per pagerepo
get-contentRetrieve file or directory contentsowner: Repository ownerrepo: Repository namepath: File/directory pathref: Branch/commit (optional)repo
list-pull-requestsList pull requests in a repositoryowner: Repository ownerrepo: Repository namestate: PR state filtersort: Sort criteriadirection: Sort directionpage: Page numberper_page: Items per pagerepo
get-pull-requestGet pull request detailsowner: Repository ownerrepo: Repository namepull_number: Pull request numberrepo
create-pull-requestCreate a new pull requestowner: Repository ownerrepo: Repository nametitle: PR titlehead: Head branchbase: Base branchbody: PR descriptiondraft: Create as draft PRrepo
merge-pull-requestMerge a pull requestowner: Repository ownerrepo: Repository namepull_number: Pull request numbermerge_method: Merge methodcommit_title: Commit titlecommit_message: Commit messagerepo
list-issuesList issues in a repositoryowner: Repository ownerrepo: Repository namestate: Issue state filtersort: Sort criteriadirection: Sort directionpage: Page numberper_page: Items per pagerepo
get-issueGet issue detailsowner: Repository ownerrepo: Repository nameissue_number: Issue numberrepo
list-issue-commentsList comments on an issue or pull requestowner: Repository ownerrepo: Repository nameissue_number: Issue/PR numberpage: Page numberper_page: Items per pagerepo
create-issueCreate a new issueowner: Repository ownerrepo: Repository nametitle: Issue titlebody: Issue body contentlabels: Array of label namesassignees: Array of user loginsmilestone: Milestone IDrepo
create-repositoryCreate a new repositoryname: Repository namedescription: Repository descriptionprivate: Whether privateauto_init: Initialize with READMEgitignore_template: Add .gitignorelicense_template: Add licenseorg: Organization namerepo
update-repositoryUpdate repository settingsowner: Repository ownerrepo: Repository namedescription: New descriptionprivate: Change privacydefault_branch: Change default branchhas_issues: Enable/disable issueshas_projects: Enable/disable projectshas_wiki: Enable/disable wikiarchived: Archive/unarchiverepo
delete-repositoryDelete a repositoryowner: Repository ownerrepo: Repository nameconfirm: Confirmation (must be true)delete_repo
list-workflowsList GitHub Actions workflowsowner: Repository ownerrepo: Repository namepage: Page numberperPage: Items per pageactions:read
list-workflow-runsList workflow runsowner: Repository ownerrepo: Repository nameworkflow_id: Workflow ID/filenamebranch: Filter by branchstatus: Filter by statuspage: Page numberperPage: Items per pageactions:read
trigger-workflowTrigger a workflowowner: Repository ownerrepo: Repository nameworkflow_id: Workflow ID/filenameref: Git referenceinputs: Workflow inputsactions:write
get-license-infoGet GitHub Enterprise license information-Requires site_admin (Administrator) account
get-enterprise-statsGet GitHub Enterprise system statistics-Requires site_admin (Administrator) account

Note: For Enterprise-specific tools (get-license-info and get-enterprise-stats), a user with site administrator privileges is required. A Classic Personal Access Token is recommended, as Fine-grained tokens may not support these Enterprise-level permissions.

Using the Tools in Cursor

Once you have set up the MCP server and configured Cursor to connect to it, you can use the GitHub Enterprise tools directly in Cursor's AI chat. Here are some examples:

Listing Repositories

mcp_github_enterprise_list_repositories(owner="octocat")

Getting Repository Information

mcp_github_enterprise_get_repository(owner="octocat", repo="hello-world")

Listing Pull Requests

mcp_github_enterprise_list_pull_requests(owner="octocat", repo="hello-world", state="open")

Managing Issues

# List issues mcp_github_enterprise_list_issues(owner="octocat", repo="hello-world", state="all") # Get issue details mcp_github_enterprise_get_issue(owner="octocat", repo="hello-world", issue_number=1) # Get issue/PR comments mcp_github_enterprise_list_issue_comments(owner="octocat", repo="hello-world", issue_number=1) # Create a new issue mcp_github_enterprise_create_issue( owner="octocat", repo="hello-world", title="Found a bug", body="Here is a description of the bug", labels=["bug", "important"] )

Working with Repository Content

mcp_github_enterprise_get_content(owner="octocat", repo="hello-world", path="README.md")

Repository Management

# Create a new repository mcp_github_enterprise_create_repository( name="new-project", description="This is a new project", private=true, auto_init=true ) # Update repository settings mcp_github_enterprise_update_repository( owner="octocat", repo="hello-world", description="Updated description", has_issues=true )

User Management (Enterprise Only)

These features are specifically designed for GitHub Enterprise Server environments and require administrative permissions:

# List all users in the GitHub Enterprise instance mcp_github_enterprise_list_users(filter="active", per_page=100) # Get a specific user's details mcp_github_enterprise_get_user(username="octocat") # Create a new user (Enterprise only) mcp_github_enterprise_create_user( login="newuser", email="newuser@example.com", name="New User", company="ACME Inc." ) # Update a user's information (Enterprise only) mcp_github_enterprise_update_user( username="octocat", email="updated-email@example.com", location="San Francisco" ) # Suspend a user (Enterprise only) mcp_github_enterprise_suspend_user( username="octocat", reason="Violation of terms of service" ) # Unsuspend a user (Enterprise only) mcp_github_enterprise_unsuspend_user(username="octocat") # List organizations a user belongs to mcp_github_enterprise_list_user_orgs(username="octocat")

API Improvements

  • Flexible API URL configuration (supports various environment variables and command-line arguments)
  • Enhanced error handling and timeout management
  • User-friendly response formatting and messages

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

An MCP server that enables integration with GitHub Enterprise API, allowing users to access repository information, manage issues, pull requests, workflows, and other GitHub features through Cursor.

  1. Compatibility
    1. Key Features
      1. Getting Started
        1. Prerequisites
        2. Docker Installation and Setup
        3. Installation and Setup
        4. Installation and Setup for Production
      2. Integration with AI Tools
        1. Claude Desktop
        2. Cursor
      3. Language Configuration
        1. Environment Variables
        2. Command-line Arguments
      4. Additional Options in HTTP Mode
        1. Available MCP Tools
          1. Using the Tools in Cursor
            1. Listing Repositories
            2. Getting Repository Information
            3. Listing Pull Requests
            4. Managing Issues
            5. Working with Repository Content
            6. Repository Management
            7. User Management (Enterprise Only)
          2. API Improvements
            1. Contributing
              1. License

                Related MCP Servers

                • GitHub MCP Serverofficial

                  modelcontextprotocol
                  A
                  security
                  A
                  license
                  A
                  quality
                  MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
                  Last updated -
                  22,573
                  66,971
                  MIT License

                • GitHub MCP Server Plus

                  PhialsBasement
                  A
                  security
                  F
                  license
                  A
                  quality
                  MCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.
                  Last updated -
                  18
                  0
                  4
                  • Linux
                  • Apple

                • mcp-github-trending

                  hetaoBackend
                  A
                  security
                  A
                  license
                  A
                  quality
                  A MCP server that provides access to GitHub trending repositories and developers data through a simple API interface.
                  Last updated -
                  2
                  32
                  MIT License
                  • Apple

                • GitHub CLI MCP Server

                  CodingButterBot
                  -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that wraps around the GitHub CLI tool, allowing AI assistants to interact with GitHub repositories through commands for pull requests, issues, and repository operations.
                  Last updated -
                  10
                  MIT License
                  • Linux
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/ddukbg/github-enterprise-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server