MCP 服务器

Bounteous MCP Server

用于管理 GitHub 操作的 MCP 服务器存储库

ravi-accolite

开发者工具

访问服务器

README

Bounteous MCP 服务器

一个为 Bounteous 组织设计的模型上下文协议 (MCP) 服务器实现，旨在实现 LLM 应用和版本控制系统（GitHub 和 GitLab）之间的无缝集成。

概述

此 MCP 服务器提供了一种标准化的方式，将大型语言模型 (LLM) 与版本控制系统连接起来，从而实现强大的自动化和集成功能。它遵循模型上下文协议规范构建。

功能

版本控制集成

GitHub 集成
- 仓库管理
- 问题跟踪
- Pull Request 处理
- 代码审查工作流
- 高级搜索功能
- 分支管理
- 文件操作
GitLab 集成
- 项目管理
- 问题跟踪
- Merge Request 处理
- 代码审查工作流
- 仓库操作
- 分支管理
- 文件操作

常用功能

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

快速开始

前提条件

Node.js (v16 或更高版本)
npm 或 yarn 包管理器
具有适当权限的 GitLab 或 GitHub 帐户
相应服务的个人访问令牌

安装

克隆仓库：

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

安装依赖项：

npm install
# 或
yarn install

配置环境变量：

cp .env.example .env
# 编辑 .env 文件进行配置

用法

Docker

# 构建并运行 GitHub MCP 服务器
docker build -t mcp/github -f packages/bounteous-hulk/src/github/Dockerfile .
docker run -e GITHUB_PERSONAL_ACCESS_TOKEN=<your_token> mcp/github

# 构建并运行 GitLab MCP 服务器
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

# 运行 GitHub MCP 服务器
npx -y bounteous-hulk --github-token <your_token>

# 运行 GitLab MCP 服务器
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"
      }
    }
  }
}