Bounteous MCP Server

Bounteous MCP Server

Bounteous 組織向けの Model Context Protocol（MCP）サーバー実装です。LLM アプリケーションとバージョン管理システム（GitHub および GitLab）をシームレスに統合できます。

概要

この MCP サーバーは、LLM とバージョン管理システムを接続するための標準化された方法を提供し、高度な自動化と統合機能を実現します。Model Context Protocol の仕様に準拠して構築されています。

機能

バージョン管理の統合

• GitHub の統合

  • リポジトリ管理
  • Issue の追跡
  • プルリクエストの処理
  • コードレビューのワークフロー
  • 高度な検索機能
  • ブランチ管理
  • ファイル操作

• GitLab の統合

  • プロジェクト管理
  • Issue の追跡
  • マージリクエストの処理
  • コードレビューのワークフロー
  • リポジトリ操作
  • ブランチ管理
  • ファイル操作

共通機能

• ブランチの自動作成
• 包括的なエラー処理
• 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. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• Model Context Protocol の仕様を使用して構築
• MCP のリファレンス実装およびコミュニティサーバーに着想を得ています

サポート

サポートやご質問については、リポジトリに Issue を作成するか、Bounteous 開発チームにお問い合わせください。

---

Bounteous 開発チームが ❤️ を込めて構築