GitHub Enterprise MCP Server

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
• 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)

Installation and Setup

Option 1: Using URL Mode (Recommended for Local Development)

1. Clone the repository and install required packages:

shell git clone https://github.com/ddukbg/github-enterprise-mcp.git cd github-enterprise-mcp npm install

1. Build the project:

shell npm run build chmod +x dist/index.js

1. Run the server:

shell export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" node dist/index.js --transport http --debug

1. Connect to Cursor using URL mode:

Add the following to your Cursor's .cursor/mcp.json file:

json { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse" } } }

Option 2: Install as a Global Command (npm link)

# 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)

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

Recommended: URL Mode (Most Stable)

1. Start the server in a separate terminal window:

shell 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

1. Configure Cursor's MCP settings:

2. Open Cursor and go to Settings

3. Navigate to AI > MCP Servers
4. Edit your .cursor/mcp.json file:

json { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse", "env": { "GITHUB_ENTERPRISE_URL": "https://github.your-company.com/api/v3", "GITHUB_TOKEN": "your_github_token" } } } }

1. Restart Cursor to apply the changes

Alternative: Command Mode

1. Open Cursor and go to Settings
2. Navigate to AI > MCP Servers
3. Click Add MCP Server
4. Enter the following details:
5. Name: GitHub Enterprise
6. Command: npx
7. Arguments: @ddukbg/github-enterprise-mcp
8. 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"
      }
    }
  }
}

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

Available MCP Tools

Note: For Enterprise-specific tools (get-license-info and get-enterprise-stats), a Classic Personal Access Token with admin:enterprise scope is required. Fine-grained tokens do 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)

# 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
)

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

About

github-enterprise-mcp

Resources

Readme

Activity

Stars

3 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

1 tags

Packages 0

No packages published

Languages

• TypeScript 66.2%
• JavaScript 33.8%