Dockerized Github MCP Server

🚀 Dockerized GitHub MCP Server

This Dockerized solution offers Model Context Protocol (MCP) support via GitHub's API, enabling diverse operations like file management, repository creation, issue tracking, and code search.

🚀 Quick Start

The GitHub MCP Server is a Dockerized solution that provides Model Context Protocol (MCP) support through GitHub's API. It's a powerful server that supports a variety of operations, including file management, repository creation, issue tracking, and code search.

✨ Features

Key Features

1. File Operations:

   • create_or_update_file: Create or update a single file.
   • push_files: Commit multiple files in one go.
   • get_file_contents: Retrieve file contents.

2. Repository Management:

   • create_repository: Create a new repository.
   • fork_repository: Fork a repository.

3. Issue Tracking:

   • create_issue: Create a new issue.
   • update_issue: Update an existing issue.
   • add_issue_comment: Add a comment to an issue.
   • search_issues: Search for issues and pull requests.

4. Code Search:

   • search_code: Search for code snippets on GitHub.

5. Collaborative Development:

   • create_pull_request: Create a new pull request.
   • merge_pull_request: Merge a pull request.
   • get_pull_request_files: Get the list of file changes in a pull request.

📦 Installation

Install Dependencies

1. Make sure you have Docker and Docker Compose installed.
2. Clone this repository:

   git clone https://github.com/modelcontextprotocol/servers.git
   cd servers/docker/github
   

Build the Image

docker build -t gh-mcp-server .

Run the Server

docker run -p 3000:3000 --name mcp-gh-server gh-mcp-server

🛠️ Supported Tools

The GitHub MCP Server supports the following features:

1. create_or_update_file - Create or update a single file in a repository.
2. push_files - Commit multiple files at once.
3. search_repositories - Search for GitHub repositories.
4. create_repository - Create a new GitHub repository.
5. get_file_contents - Retrieve the contents of a file or directory.
6. create_issue - Create a new issue.
7. create_pull_request - Create a new pull request.
8. fork_repository - Fork a repository.
9. create_branch - Create a new branch.
10. list_commits - Get the commit history of a branch.
11. list_issues - Get the list of issues in a repository.
12. update_issue - Update an existing issue.
13. add_issue_comment - Add a comment to an issue.
14. search_code - Search for code snippets.
15. search_issues - Search for issues and pull requests.
16. search_users - Search for GitHub users.
17. get_issue - Get detailed information about a specific issue.
18. get_pull_request - Get detailed information about a specific pull request.
19. merge_pull_request - Merge a pull request.

⚠️ Important Note

• Access Tokens: Ensure you use a Personal Access Token (PAT) with appropriate permissions. It's recommended to grant the minimum necessary permissions.
• API Rate Limits: Be aware of GitHub API rate limits, especially under high loads.
• Error Handling: Implement appropriate error catching and retry logic in a production environment.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.