Bounteous MCP Server

Bounteous MCP 服务

Bounteous 组织的模型上下文协议（MCP）服务实现，可在大模型应用与版本控制系统（GitHub 和 GitLab）之间实现无缝集成。

概述

此 MCP 服务提供了将大语言模型（LLM）连接到版本控制系统的标准化方式，支持强大的自动化和集成能力。它遵循模型上下文协议规范构建。

功能

版本控制集成

• GitHub 集成

  • 仓库管理
  • 问题跟踪
  • 拉取请求处理
  • 代码审查工作流
  • 高级搜索功能
  • 分支管理
  • 文件操作

• GitLab 集成

  • 项目管理
  • 问题跟踪
  • 合并请求处理
  • 代码审查工作流
  • 仓库操作
  • 分支管理
  • 文件操作

通用功能

• 自动创建分支
• 完善的错误处理
• 保留 Git 历史记录
• 支持批量操作
• 文件和目录管理
• 代码搜索功能

开始使用

前提条件

• Node.js（v16 或更高版本）
• npm 或 yarn 包管理器
• 拥有相应权限的 GitLab 或 GitHub 账号
• 相应服务的个人访问令牌

安装

1. 克隆仓库：

git clone https://github.com/ravi-accolite/mcpserver.git
cd mcpserver

2. 安装依赖：

npm install
# or
yarn install

3. 配置环境变量：

cp .env.example .env
# Edit .env with your configuration

使用方法

Docker

# Build and run GitHub MCP Server
docker build -t mcp/github -f packages/bounteous-hulk/src/github/Dockerfile .
docker run -e GITHUB_PERSONAL_ACCESS_TOKEN=<your_token> mcp/github

# Build and run GitLab MCP Server
docker build -t mcp/gitlab -f packages/bounteous-hulk/src/gitlab/Dockerfile .
docker run -e GITLAB_PERSONAL_ACCESS_TOKEN=<your_token> -e GITLAB_API_URL=https://gitlab.com/api/v4 mcp/gitlab

NPX

# Run GitHub MCP Server
npx -y bounteous-hulk --github-token <your_token>

# Run GitLab MCP Server
npx -y bounteous-hulk --gitlab-token <your_token> --gitlab-api-url https://gitlab.com/api/v4

配置（本地设置）

将以下内容添加到 .cursor/mcp.json（项目级 MCP 服务配置）或全局配置中：

{
    "mcpServers": {
        "bounteous-hulk": {
            "command": "node",
            "args": [
                "<ABSOLUTE_PATH>/mcpserver/packages/bounteous-hulk/dist/index.js"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "<GITHUB_TOKEN>",
                "VERSION_CONTROL": "<OPTION>",
                "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_TOKEN>",
                "GITLAB_API_URL": "<API_URL>"
            }
        }
    }
}

VERSION_CONTROL 可使用不同的值：github、gitlab

使用 Docker 配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "gitlab": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GITLAB_PERSONAL_ACCESS_TOKEN",
        "-e",
        "GITLAB_API_URL",
        "mcp/gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

文档

各 MCP 服务的详细文档请参阅相应目录：

• GitHub MCP 服务文档
• GitLab MCP 服务文档

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

• 根据模型上下文协议规范构建
• 灵感来自 MCP 参考实现和社区服务

支持

如需支持或有任何疑问，请在仓库中创建问题，或联系 Bounteous 开发团队。

---

由 Bounteous 开发团队倾情打造 ❤️