What is Github Mcp Server Go

github-mcp-server-go is an unofficial implementation of a GitHub Model Context Protocol (MCP) server written in Go. It allows AI assistants to interact with the GitHub API for various operations such as creating repositories, managing branches, and manipulating files.

Use cases

Use cases include automating repository management tasks, integrating GitHub functionalities into AI applications, and enhancing workflows in development teams by simplifying interactions with GitHub.

How to use

To use github-mcp-server-go, first set your GitHub personal access token as an environment variable or pass it via HTTP headers. Then, run the server using the command ‘go run main.go’.

Key features

Key features include support for repository search, repository creation, forking repositories, branch creation, file content retrieval, file creation or update, and pushing multiple files to GitHub repositories.

Where to use

github-mcp-server-go can be used in software development environments where automation of GitHub operations is required, particularly in projects involving AI assistants or tools that need to interact with GitHub.

GitHub MCP Server in Go

A Go implementation of the GitHub Model Context Protocol (MCP) server. This implementation allows AI assistants to interact with the GitHub API to perform operations such as creating repositories, managing branches, manipulating files, and more.

Prerequisites

• Go 1.21 or higher
• A GitHub personal access token with appropriate permissions

Installation

go get github.com/metoro-io/github-mcp-server-go

Authentication

The server supports two methods of authentication:

Environment Variable Authentication

Set your GitHub personal access token as an environment variable:

export GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

HTTP Header Authentication

The server can also extract authentication tokens from HTTP requests. You can pass your GitHub token via the Authorization header:

Authorization: Bearer your_github_token

or simply:

Authorization: your_github_token

Context Passthrough

For HTTP handlers, the server supports both:

1. The standard http_request context value for HTTP requests.
2. The ginContext value when using the Gin framework.

This enables seamless integration with different web frameworks while maintaining a consistent authentication mechanism.

Usage

1. Set your GitHub personal access token (as described in the Authentication section).

2. Run the server:

go run main.go

Available Tools

The server provides the following tools:

• search_repositories: Search for GitHub repositories
• create_repository: Create a new GitHub repository in your account
• fork_repository: Fork a GitHub repository to your account or specified organization
• create_branch: Create a new branch in a GitHub repository
• get_file_contents: Get the contents of a file or directory from a GitHub repository
• create_or_update_file: Create or update a single file in a GitHub repository
• push_files: Push multiple files to a GitHub repository in a single commit
• create_issue: Create a new issue in a GitHub repository
• get_issue: Get details of a specific issue in a GitHub repository
• list_issues: List issues in a GitHub repository with filtering options
• update_issue: Update an existing issue in a GitHub repository
• add_issue_comment: Add a comment to an existing issue
• list_commits: Get list of commits of a branch in a GitHub repository
• search_code: Search for code across GitHub repositories
• search_issues: Search for issues and pull requests across GitHub repositories
• search_users: Search for users on GitHub

Development

Project Structure

• main.go: Entry point for the application
• common/: Common utilities and error handling
• operations/: GitHub API operations implementation
• tools/: MCP tool definitions and handlers

Building from Source

go build -o github-mcp-server

Running Tests

go test ./...

License

This project is licensed under the MIT License.