@ 社区模板
通过 MCP 协议提供 Gitlab 服务调用,支持项目仓库管理、文件操作等功能。
文件创建/更新
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
file_path | string | 必填 | 文件存储路径(需包含扩展名) |
content | string | 必填 | 文件内容 |
commit_message | string | 必填 | 提交描述 |
branch | string | 必填 | 创建/更新文件的分支 |
previous_path | string | 可选 | 要移动/重命名的文件路径 |
返回: 文件内容和提交详情
批量推送文件
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
branch | string | 必填 | 要推送到的分支 |
files | array | 必填 | 要推送的文件,每个文件包含 file_path 和 content |
commit_message | string | 必填 | 提交信息 |
返回: 更新的分支引用
仓库搜索
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
search | string | 必填 | 搜索关键词 |
page | number | 可选 | 分页页码 |
per_page | number | 可选 | 每页结果数(默认20) |
返回: 仓库搜索结果
创建仓库
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
name | string | 必填 | 仓库名称 |
description | string | 可选 | 项目描述 |
visibility | string | 可选 | 可见性级别:private /internal /public (默认private) |
initialize_with_readme | boolean | 可选 | 是否自动生成README.md |
返回: 创建的项目详细信息
获取文件或目录的内容
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
file_path | string | 必填 | 文件/目录路径 |
ref | string | 可选 | 要获取内容的分支/标签/提交 |
返回: 文件/目录内容
创建issue
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
title | string | 必填 | issue 标题 |
description | string | 可选 | issue 描述 |
assignee_ids | number[] | 可选 | 被指派人ID数组 |
labels | string[] | 可选 | 标签数组 |
milestone_id | number | 可选 | 里程碑ID |
返回: 创建的 issue 详情
创建合并请求
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
source_branch | string | 必填 | 源分支名称 |
target_branch | string | 必填 | 要合并到的分支 |
draft | boolean | 可选 | 作为草稿合并请求创建 |
allow_collaboration | boolean | 可选 | 允许来自上游成员的提交 |
title | string | 必填 | MR 标题 |
description | string | 可选 | MR 描述 |
返回: 创建的合并请求详情
分叉仓库
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
namespace | string | 可选 | 要fork到的目标命名空间 |
返回: 分叉项目的详细信息
创建分支
参数名称 | 类型 | 是否可选 | 功能描述 |
---|---|---|---|
project_id | string | 必填 | 项目 ID 或 URL 编码路径 |
branch | string | 必填 | 新分支名称 |
ref | string | 可选 | 源分支 |
返回: 创建的分支引用
https://github.com/modelcontextprotocol/servers/tree/main/src/gitlab