使用说明
更好的GitLab MCP服务器
@zereight/mcp gitlab
GitLab MCP(模型上下文协议)服务器。 包括对原始GitLab MCP服务器的错误修复和改进。
用法
与Claude App、Cline、Roo Code、Cursor配合使用
使用Claude应用程序时,您需要直接设置API密钥和URL。
新巴拿马型船舶
{
"mcpServers": {
"GitLab communication server": {
"command": "npx",
"args": ["-y", "@zereight/mcp-gitlab"],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
"GITLAB_API_URL": "your_gitlab_api_url",
"GITLAB_READ_ONLY_MODE": "false",
"USE_GITLAB_WIKI": "false", // use wiki api?
"USE_MILESTONE": "false", // use milestone api?
"USE_PIPELINE": "false" // use pipeline api?
}
}
}
}
码头工人
- 标准
{
"mcpServers": {
"GitLab communication server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITLAB_PERSONAL_ACCESS_TOKEN",
"-e",
"GITLAB_API_URL",
"-e",
"GITLAB_READ_ONLY_MODE",
"-e",
"USE_GITLAB_WIKI",
"-e",
"USE_MILESTONE",
"-e",
"USE_PIPELINE",
"iwakitakuma/gitlab-mcp"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
"GITLAB_API_URL": "https://gitlab.com/api/v4", // Optional, for self-hosted GitLab
"GITLAB_READ_ONLY_MODE": "false",
"USE_GITLAB_WIKI": "true",
"USE_MILESTONE": "true",
"USE_PIPELINE": "true"
}
}
}
}
- SSE
docker run -i --rm \
-e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
-e GITLAB_API_URL= "https://gitlab.com/api/v4"\
-e GITLAB_READ_ONLY_MODE=true \
-e USE_GITLAB_WIKI=true \
-e USE_MILESTONE=true \
-e USE_PIPELINE=true \
-e SSE=true \
-p 3333:3002 \
iwakitakuma/gitlab-mcp
{
"mcpServers": {
"GitLab communication server": {
"url": "http://localhost:3333/sse"
}
}
}
Docker镜像推送
$ sh scripts/image_push.sh docker_user_name
环境变量
GITLAB_PERSONAL_ACCESS_TOKEN:您的GitLab个人访问令牌。GITLAB_API_URL:您的GitLab API URL。(默认值:https://gitlab.com/api/v4)GITLAB_READ_ONLY_MODE:设置为“true”时,限制服务器仅公开只读操作。对于增强安全性或不需要写访问时很有用。对于与游标一起使用也很有用,它有40个工具限制。USE_GITLAB_WIKI:设置为“true”时,启用wiki相关工具(list_wiki_pages、get_wiki_page、create_wiki_page、update_wiki_ppage、delete_wiki_plage)。默认情况下,wiki功能处于禁用状态。USE_MILESTONE:当设置为“true”时,启用与里程碑相关的工具(list_milestones、get_milestone、create_milestone、edit_milestone、delete_milestone-issue、get_milstone_merge_requests、promote_milestoney、get_miletone_burndown_events)。默认情况下,里程碑功能处于禁用状态。USE_PIPELINE:当设置为“true”时,启用与管道相关的工具(list_pipelines、get_pipeline、list_pipeline_jobs、get_pipeline_job、get_pip _job_output、create_pipeline、retry_pipeline、cancel_pipeline)。默认情况下,管道功能处于禁用状态。
工具🛠️
+
create_or_update_file-在GitLab项目中创建或更新单个文件search_repositories-搜索GitLab项目create_repository-创建一个新的GitLab项目get_file_contents-从GitLab项目中获取文件或目录的内容push_files-在一次提交中将多个文件推送到GitLab项目中create_issue-在GitLab项目中创建新问题create_merge_request-在GitLab项目中创建新的合并请求fork_repository-将GitLab项目分叉到您的帐户或指定的命名空间create_branch-在GitLab项目中创建一个新分支get_merge_request-获取合并请求的详细信息(必须提供mergeRequestIid或branchName)get_merge_request_diffs-获取合并请求的更改/差异(必须提供mergeRequestIid或branchName)get_branch_diffs-获取GitLab项目中两个分支或提交之间的更改/差异update_merge_request-更新合并请求(必须提供mergeRequestIid或branchName)create_note-为问题或合并请求创建新注释(注释)create_merge_request_thread-在合并请求上创建新线程mr_discussions-列出合并请求的讨论项update_merge_request_note-修改现有的合并请求线程注释create_merge_request_note-向现有合并请求线程添加新注释update_issue_note-修改现有问题线索注释create_issue_note-向现有问题线程添加新注释list_issues-使用过滤选项列出GitLab项目中的问题get_issue-获取GitLab项目中特定问题的详细信息update_issue-更新GitLab项目中的问题delete_issue-从GitLab项目中删除问题list_issue_links-列出特定问题的所有问题链接list_issue_discussions-列出GitLab项目中某个问题的讨论get_issue_link-获取特定问题链接create_issue_link-在两个问题之间创建问题链接delete_issue_link-删除问题链接list_namespaces-列出当前用户可用的所有命名空间get_namespace-通过ID或路径获取命名空间的详细信息verify_namespace-验证命名空间路径是否存在get_project-获取特定项目的详细信息list_projects-列出当前用户可访问的项目list_labels-列出项目的标签get_label-从项目中获取单个标签create_label-在项目中创建新标签update_label-更新项目中的现有标签delete_label-从项目中删除标签list_group_projects-列出GitLab组中具有筛选选项的项目list_wiki_pages-列出GitLab项目中的wiki页面get_wiki_page-获取特定wiki页面的详细信息create_wiki_page-在GitLab项目中创建一个新的wiki页面update_wiki_page-更新GitLab项目中的现有wiki页面delete_wiki_page-从GitLab项目中删除wiki页面get_repository_tree-获取GitLab项目的存储库树(列出文件和目录)list_pipelines-列出GitLab项目中带有过滤选项的管道get_pipeline-获取GitLab项目中特定管道的详细信息list_pipeline_jobs-列出特定管道中的所有作业get_pipeline_job-获取GitLab管道作业号的详细信息get_pipeline_job_output-获取GitLab管道作业号的输出/跟踪create_pipeline-为分支或标记创建新管道retry_pipeline-重试失败或取消的管道cancel_pipeline-取消正在运行的管道list_merge_requests-在GitLab项目中列出带有过滤选项的合并请求list_milestones-列出GitLab项目中具有过滤选项的里程碑get_milestone-获取特定里程碑的详细信息create_milestone-在GitLab项目中创建新的里程碑edit_milestone-编辑GitLab项目中的现有里程碑delete_milestone-从GitLab项目中删除里程碑get_milestone_issue-获取与特定里程碑相关的问题get_milestone_merge_requests-获取与特定里程碑关联的合并请求promote_milestone-将里程碑推进到下一阶段get_milestone_burndown_events-获取特定里程碑的烧毁事件get_users-按用户名获取GitLab用户详细信息