Github Actions

🚀 GitHub Actions MCP Server

This repository contains the implementation of a Model Context Protocol (MCP) server for managing GitHub Actions workflows and resources. The server is designed to interact with GitHub repositories and provides tools, resources, and prompts to automate and manage workflows.

🚀 Quick Start

The GitHub Actions MCP Server is designed to interact with GitHub repositories, offering tools, resources, and prompts for workflow automation and management. Here's how to get started:

Prerequisites

• Docker
• Node.js (v16 or higher)
• GitHub Personal Access Token (PAT) with appropriate permissions

Setup

1. Clone the repository:

   git clone https://github.com/devopsier/github-actions-mcp.git
   cd github-actions-mcp
   

2. Install dependencies:

   npm install
   

3. Build the Docker image:

   docker build -t github-actions-mcp .
   

4. Run the server:

   docker run -i --rm -e GITHUB_TOKEN=<your_github_token> -e GITHUB_TYPE=cloud github-actions-mcp
   

Configuration

The server can be configured via the settings.json file in your VS Code workspace. Example:

"mcp": {
    "servers": {
        "mcp-github-actions": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "GITHUB_TOKEN",
                "-e",
                "GITHUB_TYPE",
                "github-actions-mcp"
            ],
            "env": {
                "GITHUB_TOKEN": "<your_github_token>",
                "GITHUB_TYPE": "cloud"
            }
        }
    }
}

✨ Features

• Resource Management: Retrieve and manage GitHub repositories and workflows.
• Tool Execution: Trigger workflows and manage GitHub Actions tools.
• Prompt Generation: Create issues, review pull requests, etc.

📦 Project Structure

/app/github-actions-mcp-server
├── Dockerfile
├── package.json
├── tsconfig.json
├── src/
│   ├── http-server.ts
│   ├── server.backup.ts
│   ├── server.ts
│   ├── stdio-server.ts
│   ├── github/
│   │   └── client.ts
│   └── utils/
│       └── utils.ts

🤝 Contributing

We welcome contributions to the GitHub Actions MCP Server project! To contribute, please follow these steps:

1. Fork the repository on GitHub.
2. Create a new branch for your feature or bug fix:

   git checkout -b my-feature-branch
   

3. Commit your changes with clear and concise commit messages.
4. Push your branch to your forked repository:

   git push origin my-feature-branch
   

5. Open a pull request to the main repository and describe your changes in detail.

For more details, please refer to the CONTRIBUTING.md file.

📄 License

This project is licensed under the MIT License. For more information, please refer to the LICENSE file.