Custom GitLab MCP Server

カスタム GitLab MCP サーバー

Claude やその他の MCP 対応 AI アシスタントと連携するための、カスタム実装の GitLab MCP（Model Context Protocol）サーバーです。

概要

この MCP サーバーは GitLab リポジトリとのシームレスな連携を実現し、AI アシスタントが次の操作を行えるようにします。

• GitLab リポジトリを検索する
• ファイルの内容を取得する
• ファイルを作成または更新する
• 複数のファイルを 1 つのコミットでプッシュする
• イシューやマージリクエストを作成する
• リポジトリをフォークする
• ブランチを作成する

修正版の実装

このカスタム実装では、標準の GitLab MCP サーバー実装に存在していたスキーマ検証の問題を修正しています。具体的には、search_repositories ツールの問題に対応しています。

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします。

   npm install
   

3. Claude の設定ファイルまたは Claude Desktop の設定ファイルで設定します。

   {
     "mcpServers": {
       "github.com/modelcontextprotocol/servers/tree/main/src/gitlab": {
         "command": "node",
         "args": [
           "/path/to/custom-gitlab-server/index.js"
         ],
         "env": {
           "GITLAB_PERSONAL_ACCESS_TOKEN": "your-gitlab-token",
           "GITLAB_API_URL": "https://your-gitlab-instance/api/v4"
         }
       }
     }
   }
   

前提条件

• Node.js（v14 以降）
• 適切なスコープを持つ GitLab パーソナルアクセストークン：
  • api：完全な API アクセス用
  • read_api：読み取り専用アクセス用
  • read_repository および write_repository：リポジトリ操作用

利用可能なツール

ツール名	説明
search_repositories	GitLab プロジェクトを検索する
get_file_contents	ファイルまたはディレクトリの内容を取得する
create_or_update_file	単一のファイルを作成または更新する
push_files	複数のファイルを 1 つのコミットでプッシュする
create_repository	新しい GitLab プロジェクトを作成する
create_issue	新しいイシューを作成する
create_merge_request	新しいマージリクエストを作成する
fork_repository	プロジェクトをフォークする
create_branch	新しいブランチを作成する

ライセンス

MIT