Gitlab Mr MCP

🚀 GitLab MR MCP

このサーバーは、Model Context Protocol (MCP) を使用して、GitLab のマージリクエストやイシューとのやり取りを実現します。

🚀 クイックスタート

このプロジェクトは、Model Context Protocol (MCP) に基づくサーバーを実装しており、AI エージェントが GitLab リポジトリとやり取りできるようにします。以下の機能を提供します：

• 利用可能な GitLab プロジェクトをリストする
• マージリクエストの詳細情報とコメントを取得する
• マージリクエストのコード差分を取得する
• マージリクエストにコメントを追加する
• コード差分の特定の行に注釈を追加する
• イシューの詳細情報を取得する

✨ 主な機能

• 利用可能な GitLab プロジェクトをリストする
• マージリクエストの詳細情報とコメントを取得する
• マージリクエストのコード差分を取得する
• マージリクエストにコメントを追加する
• コード差分の特定の行に注釈を追加する
• イシューの詳細情報を取得する

📦 インストール

⚡ Smithery を使用する場合

Claude Desktop で使用するために、Smithery を通じて GitLab MR MCP を自動インストールするには：

npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}"'

🛠️ 手動インストール

🔧 前提条件

• Node.js
• API アクセス権限を持つ GitLab アクセストークン
• GitLab プロジェクト ID(s)

📖 設定

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

npm install

3. 以下の内容を MCP クライアント設定に追加する：

{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"]
    },
    "env": {
      "MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
      "MR_MCP_GITLAB_HOST": "your_gitlab_host"
    }
  }
}

🛠️ 利用可能なツール

• get_projects アクセス可能なすべての GitLab プロジェクトのリストを取得します。

• list_open_merge_requests 指定されたプロジェクト内のすべてのオープンなマージリクエストをリストします。

• get_merge_request_details 特定のマージリクエストの詳細情報を取得します。

• get_merge_request_comments 特定のマージリクエスト上のコメント（ディスカッションノートやコード差分注釈を含む）を取得します。

• add_merge_request_comment 特定のマージリクエストに一般的なコメントを追加します。

• add_merge_request_diff_comment 特定のファイルの特定の行にマージリクエストの注釈を追加します。

• get_merge_request_diff マージリクエストのコード差分を取得します。

• get_issue_details 特定のイシューの詳細情報を取得します。

🏗️ 開発

🔍 Inspector を実行する

環境変数を設定します：

export MR_MCP_GITLAB_TOKEN=your_gitlab_token
export MR_MCP_GITLAB_HOST=your_gitlab_host

MCP クライアントと一緒に使用する場合は、以下を実行できます：

npx -y @modelcontextprotocol/inspector npm start

🛠️ トラブルシューティング

権限エラー（403 禁止）が発生した場合は、以下を確認してください：

1. GitLab トークンが適切なスコープ（api, read_api）を持っていること
2. トークンユーザーがプロジェクトに適切なアクセス権限を持っていること
3. プロジェクト ID が正しいこと

📄 ライセンス

MIT

🤝 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。