mcpserver

ravi-accolite/mcpserver

3.1

If you are the rightful owner of mcpserver and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

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

  1. Clone the repository:
git clone https://github.com/ravi-accolite/mcpserver.git
cd mcpserver
  1. Install dependencies:
npm install
# or
yarn install
  1. 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

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

License

This project is licensed under the MIT License - see the 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