Custom Gitlab Server

🚀 GitLab MCP サーバーガイド

GitLab MCP サーバーは、GitLab に統合されたツールです。Model Context Protocol（MCP）を通じて、様々な開発ツールやサービスとの相互作用を提供します。開発者はコードリポジトリから直接情報を取得し、他のサービスと通信することができます。

✨ 主な機能

このサーバーは以下の機能を提供します。

• コードリポジトリアクセス：GitLab リポジトリから直接コードと関連情報を取得できます。
• 統合開発環境サポート：VS Code、IntelliJ IDEA などの IDE とのシームレスな接続をサポートします。
• 問題追跡：GitLab プロジェクト内の問題やマージリクエストを表示および管理できます。
• チームコラボレーション：チームメンバー間のコラボレーションを促進し、リアルタイムのフィードバックとコードレビューを提供します。

📦 インストール

前提条件

GitLab MCP サーバーを実行する前に、以下の環境設定を確認してください。

1. オペレーティングシステム要件：

   • Node.js のサポートバージョン（LTS バージョンの使用を推奨）。
   • Windows、macOS、または Linux システムがサポートされています。

2. ツールのインストール：

   • Node.js と npm をインストールしてください。
   • システムに Git がインストールされていることを確認してください。

3. 環境変数の設定：

   • GITLAB_PERSONAL_ACCESS_TOKEN を設定してください。これは GitLab API と通信するためのアクセストークンで、GitLab アカウント設定で生成する必要があります。
   • GITLAB_API_URL の設定はオプションです。自社管理の GitLab インスタンスを使用する場合は、その API アドレスを指定する必要があります。

インストール手順

リポジトリのクローン

git clone https://github.com/yourusername/gitlab-mcp-server.git

依存関係のインストール

クローンしたプロジェクトディレクトリに移動し、必要な依存関係をインストールします。

cd gitlab-mcp-server
npm install

環境変数の設定

.env ファイルを作成し、以下の内容を追加します。

GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
GITLAB_API_URL=https://gitlab.example.com  # 自社管理の場合はこのアドレスを記入

サーバーのビルド

プロジェクトをビルドし、実行可能に設定します。

npm run build

💻 使用例

サーバーの起動

直接実行

ビルドしたファイルを Node.js で実行します。

node build/index.js

npx を使用する場合

グローバルにインストールされている場合は、npx を使用して直接実行できます。

npx @yourusername/gitlab-mcp-server

統合（例：Claude Desktop）

claude_desktop_config.json に以下の設定を追加します。

npx を使用する場合

{
  "mcpServers": {
    "@yourusername/gitlab-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yourusername/gitlab-mcp-server"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "...",
        "GITLAB_API_URL": "..."
      }
    }
  }
}

ローカルビルドを使用する場合

{
  "mcpServers": {
    "@yourusername/gitlab-mcp-server": {
      "command": "/full/path/to/your/custom-gitlab-server/build/index.js",
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "...",
      }
    }
  }
}