Bounteous MCP Server

A Model Context Protocol (MCP) server implementation for Bounteous organization, enabling seamless integration between LLM applications and version control systems (GitHub and GitLab).

Overview

This MCP server provides a standardized way to connect Large Language Models (LLMs) with version control systems, enabling powerful automation and integration capabilities. Built following the Model Context Protocol specifications.

Features

Version Control Integration

GitHub Integration
- Repository management
- Issue tracking
- Pull request handling
- Code review workflows
- Advanced search capabilities
- Branch management
- File operations
GitLab Integration
- Project management
- Issue tracking
- Merge request handling
- Code review workflows
- Repository operations
- Branch management
- File operations

Common Features

Automatic branch creation
Comprehensive error handling
Git history preservation
Batch operations support
File and directory management
Code search capabilities

Getting Started

Prerequisites

Node.js (v16 or higher)
npm or yarn package manager
GitLab or GitHub account with appropriate permissions
Personal Access Token for the respective service

Installation

Clone the repository:

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

Install dependencies:

npm install
# or
yarn install

Configure environment variables:

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

Usage

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

Configuration (Local Setup)

Add the following to your .cursor/mcp.json (project level mcp server) or global level:

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

Different VERSION_CONTROL value possible: github, gitlab

Configuration with Docker

Add the following to your 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"
      }
    }
  }
}

Documentation

Detailed documentation for each MCP server is available in their respective directories:

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

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

Acknowledgments

Built using the Model Context Protocol specification
Inspired by the MCP reference implementation and community servers

Support

For support and questions, please create an issue in the repository or contact the Bounteous development team.

Built with ❤️ by Bounteous Development Team