GitHub Actions MCP 服务器

此仓库包含用于管理GitHub Actions工作流和资源的模型上下文协议（MCP）服务器的实现。该服务器设计用于与GitHub仓库交互，并提供工具、资源和提示，以自动化和管理 workflows。

功能

• 资源管理：获取并管理GitHub仓库和工作流。
• 工具执行：触发工作流并管理GitHub Actions工具。
• 提示生成：创建问题、审查拉取请求等。

项目结构

/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

先决条件

• Docker
• Node.js（v16或更高版本）
• GitHub个人访问令牌（PAT）及其适当权限

设置

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建Docker镜像：

   docker build -t github-actions-mcp .
   

4. 运行服务器：

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

配置

服务器可通过你的VS Code工作区中的settings.json文件进行配置。示例：

"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"
            }
        }
    }
}

贡献

我们欢迎对GitHub Actions MCP Server项目做出贡献！要进行贡献，请按照以下步骤操作：

1. 在GitHub上 fork 该仓库。
2. 创建新功能或修复错误的分支：

   git checkout -b my-feature-branch
   

3. 提交更改，使用清晰简洁的消息描述更改内容。
4. 将你的分支推送到forked仓库：

   git push origin my-feature-branch
   

5. 打开到主仓库的pull request，并详细说明你的更改。

有关更多细节，请参阅CONTRIBUTING.md文件。

许可证

此项目根据MIT License授权。有关详细信息，请参阅LICENSE文件。