create_merge_request
Create a new merge request in GitLab to propose code changes from a source branch to a target branch, with options for title, description, assignee, and reviewers.
Instructions
建立新的 Merge Request
Args: project_id: 專案 ID 或路徑 source_branch: 來源分支 target_branch: 目標分支 title: MR 標題 description: MR 描述 assignee_id: 指派人 ID reviewer_ids: 審核者 ID 列表（逗號分隔，如 "1,2,3"）
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| source_branch | Yes | ||
| target_branch | Yes | ||
| title | Yes | ||
| description | No | ||
| assignee_id | No | ||
| reviewer_ids | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/gitlab_mcp/server.py:241-282 (handler)The MCP tool registration and handler logic for 'create_merge_request', which parses input and calls the client.
@mcp.tool() def create_merge_request(project_id: int | str, source_branch: str, target_branch: str, title: str, description: str = None, assignee_id: int = None, reviewer_ids: str = None) -> str: """建立新的 Merge Request Args: project_id: 專案 ID 或路徑 source_branch: 來源分支 target_branch: 目標分支 title: MR 標題 description: MR 描述 assignee_id: 指派人 ID reviewer_ids: 審核者 ID 列表（逗號分隔，如 "1,2,3"） """ try: v = GitLabValidator.validate_merge_request_data({ "source_branch": source_branch, "target_branch": target_branch, "title": title, }) if not v.is_valid: return "驗證失敗：\n" + "\n".join(v.errors) # 解析逗號分隔的 reviewer_ids parsed_reviewer_ids = None if reviewer_ids: try: parsed_reviewer_ids = [int(x.strip()) for x in reviewer_ids.split(",")] except ValueError: return "reviewer_ids 格式錯誤，請使用逗號分隔的數字（如 1,2,3）" client = get_client() mr = client.create_merge_request( project_id, source_branch, target_branch, title, description=description, assignee_id=assignee_id, reviewer_ids=parsed_reviewer_ids ) return f"✓ MR 已建立: !{mr['iid']} — {mr['title']}\n網址: {mr.get('web_url', '')}" except GitLabAPIError as e: return f"建立 MR 失敗: {str(e)}" - src/gitlab_mcp/gitlab_client.py:196-225 (handler)The actual implementation of the 'create_merge_request' method within the GitLab client, which performs the API request.
def create_merge_request( self, project_id: int | str, source_branch: str, target_branch: str, title: str, description: str = None, assignee_id: int = None, reviewer_ids: list[int] = None, ) -> dict: """POST /projects/:id/merge_requests""" pid = self._resolve_project_id(project_id) data = { "source_branch": source_branch, "target_branch": target_branch, "title": title, } if description is not None: data["description"] = description if assignee_id is not None: data["assignee_id"] = assignee_id if reviewer_ids is not None: data["reviewer_ids"] = reviewer_ids return self._post_json(f"/projects/{pid}/merge_requests", data=data) def update_merge_request( self, project_id: int | str, mr_iid: int, **kwargs ) -> dict: """PUT /projects/:id/merge_requests/:iid