gitlab-api

MCP开发工具

提供方 Knuckles-Team · 包名 gitlab-api

开发工具 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

GitLab MCP Server and Python API Wrapper

一句话选型结论

按资料字段整理

gitlab-api 属于开发工具类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 9 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

a2a a2a-server ag-ui api gitlab-api

支持客户端

适用场景

a2aa2a-serverag-ui

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
pip install gitlab-api

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
gitlab-api当前 未标注 stdio · 本地进程 本地部署 有 2026-04-20
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Knuckles-Team上游标注的维护方 Knuckles-Team
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时gitlab-api · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-20上游最后核验时间

详细介绍

36.4 KB
来自项目仓库与上游目录的原文,未做删改

Gitlab Api

CLI or API | MCP

> Documentation — Installation, deployment, usage across the API, CLI, and MCP
> backing GitLab instance are maintained in the
> official documentation.


Overview

Gitlab Api is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with GitLab API + MCP Server.


Key Features

  • Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
  • Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
  • Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.

CLI or API

This agent wraps the GitLab API + MCP Server API. The operator can interact with it programmatically or via its integrated execution entrypoints.

Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.


MCP

This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.

Tool surface — MCP_TOOL_MODE

Set MCP_TOOL_MODE (in the shared ~/.config/agent-connector-sdk/config.json or env):
condensed (default — the action-routed tools below), verbose (one named 1:1 tool
per API method, e.g. gitlab_get_branches(...), tagged verbose), or both. Filter
the verbose set with --tools tag:verbose / MCP_ENABLED_TAGS=verbose. See the
agent-connector-sdk MCP Tool Modes guide.

Available MCP Tools

Auto-generated from the live MCP server — do not edit by hand.

Condensed action-routed tools (default — MCP_TOOL_MODE=condensed)

MCP Tool Toggle Env Var Description
api_request CUSTOM_APITOOL Execute arbitrary GitLab REST API requests directly.
gitlab_branches BRANCHESTOOL Manage gitlab branches operations.
gitlab_commits COMMITSTOOL Manage gitlab commits operations.
gitlab_deploy_tokens DEPLOY_TOKENSTOOL Manage gitlab deploy tokens operations.
gitlab_discover_graphql_schema GRAPHQLTOOL Discover the dynamic GitLab GraphQL schema including types, fields, and custom attributes in real-time.
gitlab_environments ENVIRONMENTSTOOL Manage gitlab environments operations.
gitlab_epics EPICSTOOL Manage GitLab epics.
gitlab_graphql GRAPHQLTOOL Execute raw GraphQL queries and mutations natively on GitLab.
gitlab_graphql_ops GRAPHQL_OPSTOOL Run a typed GitLab GraphQL operation by name.
gitlab_groups GROUPSTOOL Manage gitlab groups operations.
gitlab_ingest_pipelines MISCTOOL Natively ingest GitLab CI pipeline runs (+ jobs) into epistemic-graph.
gitlab_ingest_projects MISCTOOL Natively ingest GitLab projects into epistemic-graph as typed :Project nodes.
gitlab_instances MISCTOOL List the configured GitLab tenants (CONCEPT:AU-KG.backend.declared-columns-so-schema).
gitlab_issues ISSUESTOOL Manage GitLab issues.
gitlab_jobs JOBSTOOL Manage gitlab jobs operations.
gitlab_labels LABELSTOOL Manage GitLab labels.
gitlab_members MEMBERSTOOL Manage gitlab members operations.
gitlab_merge_requests MERGE_REQUESTSTOOL Manage gitlab merge requests operations.
gitlab_merge_rules MERGE_RULESTOOL Manage gitlab merge rules operations.
gitlab_milestones MILESTONESTOOL Manage GitLab milestones.
gitlab_namespaces NAMESPACESTOOL Manage gitlab namespaces operations.
gitlab_notes NOTESTOOL Manage GitLab notes/comments on issues, merge requests, commits, and epics.
gitlab_packages PACKAGESTOOL Manage gitlab packages operations.
gitlab_pipeline_schedules PIPELINE_SCHEDULESTOOL Manage gitlab pipeline schedules operations.
gitlab_pipelines PIPELINESTOOL Manage gitlab pipelines operations.
gitlab_projects PROJECTSTOOL Manage gitlab projects operations.
gitlab_protected_branches PROTECTED_BRANCHESTOOL Manage gitlab protected branches operations.
gitlab_releases RELEASESTOOL Manage gitlab releases operations.
gitlab_runners RUNNERSTOOL Manage gitlab runners operations.
gitlab_snippets SNIPPETSTOOL Manage GitLab snippets.
gitlab_tags TAGSTOOL Manage gitlab tags operations.
gitlab_users USERSTOOL Manage gitlab users operations.
gitlab_vulnerabilities VULNERABILITIESTOOL Review a project's dependency list and security vulnerabilities (the GitLab counterpart to GitHub Dependabot).
gitlab_wiki WIKITOOL Manage gitlab wiki operations.

Verbose 1:1 API-mapped tools (MCP_TOOL_MODE=verbose or both)

196 per-operation tools — one per public API method (click to expand)

MCP Tool Toggle Env Var Description
gitlab_accept_merge_request MERGE_REQUESTSTOOL Accept (merge) a merge request.
gitlab_api_request SYSTEMTOOL Make a custom API request to the GitLab server.
gitlab_approve_merge_request MERGE_REQUESTSTOOL Approve a specific merge request.
gitlab_archive_project PROJECTSTOOL Archive a specific project.
gitlab_cancel_merge_when_pipeline_succeeds MERGE_REQUESTSTOOL Cancel a merge request's queued "merge when pipeline succeeds" (auto-merge).
gitlab_cancel_project_job PROJECTSTOOL Cancel a specific job within a project.
gitlab_cherry_pick_commit REPOSITORIESTOOL Cherry-pick a commit into a new branch.
gitlab_create_branch REPOSITORIESTOOL Create a new branch in a project.
gitlab_create_commit REPOSITORIESTOOL Create a new commit.
gitlab_create_commit_comment REPOSITORIESTOOL Create a comment on a commit.
gitlab_create_environment ENVIRONMENTSTOOL Create a new environment for a project.
gitlab_create_epic ISSUESTOOL Create a new group epic.
gitlab_create_group_deploy_token USERS_GROUPSTOOL Create a deploy token for a group.
gitlab_create_issue ISSUESTOOL Create a new issue.
gitlab_create_label ISSUESTOOL Create a new label.
gitlab_create_merge_request MERGE_REQUESTSTOOL Create a new merge request.
gitlab_create_milestone ISSUESTOOL Create a project milestone.
gitlab_create_note OTHERTOOL Create a new note/comment on an issue.
gitlab_create_pipeline_schedule PIPELINESTOOL Create a pipeline schedule for a specific project.
gitlab_create_pipeline_schedule_variable PIPELINESTOOL Create a variable for a pipeline schedule.
gitlab_create_project PROJECTSTOOL Create a new project.
gitlab_create_project_deploy_token PROJECTSTOOL Create a deploy token for a project.
gitlab_create_project_level_rule PROJECTSTOOL Create a new project-level merge request approval rule.
gitlab_create_release ENVIRONMENTSTOOL Create a new release in a project.
gitlab_create_release_evidence ENVIRONMENTSTOOL Create evidence for a release in a project.
gitlab_create_snippet OTHERTOOL Create a project snippet or personal snippet.
gitlab_create_tag REPOSITORIESTOOL Create a tag in a project.
gitlab_create_user USERS_GROUPSTOOL Create a new user.
gitlab_create_wiki_page OTHERTOOL Create a new wiki page for a project.
gitlab_delete_branch REPOSITORIESTOOL Delete a branch in a project.
gitlab_delete_environment ENVIRONMENTSTOOL Delete an environment for a project.
gitlab_delete_epic ISSUESTOOL Delete a group epic.
gitlab_delete_group_deploy_token USERS_GROUPSTOOL Delete a deploy token for a group.
gitlab_delete_issue ISSUESTOOL Delete an issue.
gitlab_delete_label ISSUESTOOL Delete a label.
gitlab_delete_merged_branches REPOSITORIESTOOL Delete all merged branches in a project.
gitlab_delete_milestone ISSUESTOOL Delete a project milestone.
gitlab_delete_note OTHERTOOL Delete a note.
gitlab_delete_pipeline_schedule PIPELINESTOOL Delete a pipeline schedule for a specific project.
gitlab_delete_pipeline_schedule_variable PIPELINESTOOL Delete a variable from a pipeline schedule.
gitlab_delete_project PROJECTSTOOL Delete a specific project.
gitlab_delete_project_deploy_token PROJECTSTOOL Delete a deploy token for a project.
gitlab_delete_project_level_rule PROJECTSTOOL Delete a project-level merge request approval rule.
gitlab_delete_project_runner PROJECTSTOOL Delete a runner from a project.
gitlab_delete_release ENVIRONMENTSTOOL Delete a release in a project.
gitlab_delete_runner PIPELINESTOOL Delete a runner.
gitlab_delete_shared_project_link PROJECTSTOOL Unshare a specific project from a group.
gitlab_delete_snippet OTHERTOOL Delete a snippet.
gitlab_delete_stopped_environments ENVIRONMENTSTOOL Delete stopped environments (review apps) for a project.
gitlab_delete_tag REPOSITORIESTOOL Delete a tag in a project.
gitlab_delete_user USERS_GROUPSTOOL Delete a user.
gitlab_delete_wiki_page OTHERTOOL Delete a wiki page for a project.
gitlab_download_release_asset ENVIRONMENTSTOOL Download a release asset from a group's release.
gitlab_download_repository_package OTHERTOOL Download a repository package for a specific project.
gitlab_edit_group USERS_GROUPSTOOL Edit a specific group.
gitlab_edit_group_level_rule USERS_GROUPSTOOL Edit a group-level merge request approval setting.
gitlab_edit_pipeline_schedule PIPELINESTOOL Edit a pipeline schedule for a specific project.
gitlab_edit_project PROJECTSTOOL Edit a specific project.
gitlab_edit_project_level_rule PROJECTSTOOL Edit a project-level merge request approval setting.
gitlab_enable_project_runner PROJECTSTOOL Enable a runner in a project.
gitlab_erase_project_job PROJECTSTOOL Erase a specific job within a project.
gitlab_get_approval_state_merge_requests MERGE_REQUESTSTOOL Get the approval state of merge requests for a specific project.
gitlab_get_branch REPOSITORIESTOOL Retrieve information about a specific branch in a project.
gitlab_get_branches REPOSITORIESTOOL Retrieve information about branches in a project.
gitlab_get_commit REPOSITORIESTOOL Get a specific commit.
gitlab_get_commit_comments REPOSITORIESTOOL Get comments on a commit.
gitlab_get_commit_diff REPOSITORIESTOOL Get the diff of a commit.
gitlab_get_commit_discussions REPOSITORIESTOOL Get discussions on a commit.
gitlab_get_commit_gpg_signature REPOSITORIESTOOL Get GPG signature of a commit.
gitlab_get_commit_merge_requests REPOSITORIESTOOL Get merge requests associated with a commit.
gitlab_get_commit_references REPOSITORIESTOOL Get references of a commit.
gitlab_get_commit_statuses REPOSITORIESTOOL Get statuses of a commit.
gitlab_get_commits REPOSITORIESTOOL Get commits.
gitlab_get_deploy_tokens ENVIRONMENTSTOOL Get all deploy tokens.
gitlab_get_environment ENVIRONMENTSTOOL Get details of a specific environment.
gitlab_get_environments ENVIRONMENTSTOOL Get a list of environments for a project.
gitlab_get_epic ISSUESTOOL Get a specific group epic.
gitlab_get_epics ISSUESTOOL Get all epics for a group.
gitlab_get_group USERS_GROUPSTOOL Get details of a specific group.
gitlab_get_group_deploy_token USERS_GROUPSTOOL Get a specific deploy token for a group.
gitlab_get_group_deploy_tokens USERS_GROUPSTOOL Get deploy tokens for a specific group.
gitlab_get_group_descendant_groups USERS_GROUPSTOOL Get descendant groups of a specific group.
gitlab_get_group_issues ISSUESTOOL Get the list of issues for a group (and, by default, its subgroups).
gitlab_get_group_level_rule USERS_GROUPSTOOL Get details of a group-level merge request approval setting.
gitlab_get_group_members USERS_GROUPSTOOL Get members of a specific group.
gitlab_get_group_merge_requests MERGE_REQUESTSTOOL Get merge requests associated with a specific group.
gitlab_get_group_projects PROJECTSTOOL Get projects associated with a specific group.
gitlab_get_group_releases USERS_GROUPSTOOL Get information about releases in a group.
gitlab_get_group_runners PIPELINESTOOL Get information about runners in a group.
gitlab_get_group_subgroups USERS_GROUPSTOOL Get subgroups of a specific group.
gitlab_get_group_vulnerabilities VULNERABILITIESTOOL Get a group's security vulnerability findings (Ultimate).
gitlab_get_groups USERS_GROUPSTOOL Get a list of groups.
gitlab_get_issue ISSUESTOOL Get a single issue.
gitlab_get_issues ISSUESTOOL Get list of issues. Can filter by project_id.
gitlab_get_label ISSUESTOOL Get a specific label by name.
gitlab_get_labels ISSUESTOOL Get all labels for a project.
gitlab_get_latest_release ENVIRONMENTSTOOL Get information about the latest release in a project.
gitlab_get_latest_release_asset ENVIRONMENTSTOOL Get the asset for the latest release in a project.
gitlab_get_latest_release_evidence ENVIRONMENTSTOOL Get evidence for the latest release in a project.
gitlab_get_merge_request_level_rules MERGE_REQUESTSTOOL Get merge request-level approval rules for a specific project and merge request.
gitlab_get_merge_requests MERGE_REQUESTSTOOL Get a list of merge requests.
gitlab_get_milestone ISSUESTOOL Get a specific project milestone.
gitlab_get_milestones ISSUESTOOL Get all milestones for a project.
gitlab_get_namespace USERS_GROUPSTOOL Get information about a specific namespace.
gitlab_get_namespaces USERS_GROUPSTOOL Get information about namespaces.
gitlab_get_nested_projects_by_group PROJECTSTOOL Get information about nested projects within a group.
gitlab_get_note OTHERTOOL Get a specific note.
gitlab_get_notes OTHERTOOL Get all notes for a specific issue.
gitlab_get_pipeline PIPELINESTOOL Get information about a specific pipeline in a project.
gitlab_get_pipeline_jobs PIPELINESTOOL Get jobs associated with a specific pipeline within a project.
gitlab_get_pipeline_schedule PIPELINESTOOL Get information about a specific pipeline schedule in a project.
gitlab_get_pipeline_schedules PIPELINESTOOL Get pipeline schedules for a specific project.
gitlab_get_pipelines PIPELINESTOOL Get information about pipelines for a specific project.
gitlab_get_pipelines_triggered_from_schedule PIPELINESTOOL Get pipelines triggered from a specific pipeline schedule.
gitlab_get_project PROJECTSTOOL Get information about a specific project.
gitlab_get_project_contributors PROJECTSTOOL Get information about contributors to a project.
gitlab_get_project_dependencies VULNERABILITIESTOOL Get a project's Dependency List (all detected dependencies).
gitlab_get_project_deploy_token PROJECTSTOOL Get a specific deploy token for a project.
gitlab_get_project_deploy_tokens PROJECTSTOOL Get deploy tokens for a specific project.
gitlab_get_project_groups PROJECTSTOOL Get groups associated with a specific project.
gitlab_get_project_job PROJECTSTOOL Get details of a specific job within a project.
gitlab_get_project_job_log PROJECTSTOOL Get the log of a specific job within a project.
gitlab_get_project_jobs PROJECTSTOOL Get jobs associated with a specific project.
gitlab_get_project_level_merge_request_rule PROJECTSTOOL Get details of a specific project-level merge request approval rule.
gitlab_get_project_level_merge_request_rules PROJECTSTOOL Get project-level merge request approval rules.
gitlab_get_project_level_rule PROJECTSTOOL Get details of a project-level merge request approval setting.
gitlab_get_project_members PROJECTSTOOL Get members of a specific project.
gitlab_get_project_merge_request PROJECTSTOOL Get details of a specific merge request in a project.
gitlab_get_project_merge_requests PROJECTSTOOL Get merge requests for a specific project.
gitlab_get_project_runners PROJECTSTOOL Get information about runners in a project.
gitlab_get_project_statistics PROJECTSTOOL Get statistics for a specific project.
gitlab_get_project_vulnerabilities VULNERABILITIESTOOL Get a project's security vulnerabilities (Ultimate).
gitlab_get_projects PROJECTSTOOL Get information about projects.
gitlab_get_protected_branch REPOSITORIESTOOL Get information about a specific protected branch in a project.
gitlab_get_protected_branches REPOSITORIESTOOL Get information about protected branches in a project.
gitlab_get_protected_environment ENVIRONMENTSTOOL Get details of a specific protected environment.
gitlab_get_protected_environments ENVIRONMENTSTOOL Get a list of protected environments for a project.
gitlab_get_protected_tag REPOSITORIESTOOL Get information about a specific protected tag in a project.
gitlab_get_protected_tags REPOSITORIESTOOL Get information about protected tags in a project.
gitlab_get_release_by_tag REPOSITORIESTOOL Get information about a release by its tag in a project.
gitlab_get_releases ENVIRONMENTSTOOL Get information about releases in a project.
gitlab_get_repository_packages OTHERTOOL Get information about repository packages for a specific project.
gitlab_get_runner PIPELINESTOOL Get information about a specific runner.
gitlab_get_runner_jobs PIPELINESTOOL Get jobs for a specific runner.
gitlab_get_runners PIPELINESTOOL Get information about runners.
gitlab_get_snippet OTHERTOOL Get a specific snippet.
gitlab_get_snippets OTHERTOOL Get list of snippets. Can filter by project_id.
gitlab_get_tag REPOSITORIESTOOL Get information about a specific tag in a project.
gitlab_get_tags REPOSITORIESTOOL Get information about tags in a project.
gitlab_get_user USERS_GROUPSTOOL Get information about a specific user.
gitlab_get_users USERS_GROUPSTOOL Get information about users.
gitlab_get_vulnerability VULNERABILITIESTOOL Get a single vulnerability by its global ID (Ultimate).
gitlab_get_wiki_list OTHERTOOL Get a list of wiki pages for a project.
gitlab_get_wiki_page OTHERTOOL Get information about a specific wiki page.
gitlab_merge_request_level_approvals MERGE_REQUESTSTOOL Get approvals for a specific merge request.
gitlab_pause_runner PIPELINESTOOL Pause or unpause a specific runner.
gitlab_post_build_status_to_commit REPOSITORIESTOOL Post build status to a commit.
gitlab_protect_branch REPOSITORIESTOOL Protect a specific branch in a project.
gitlab_protect_environment ENVIRONMENTSTOOL Protect an environment for a project.
gitlab_protect_tag REPOSITORIESTOOL Protect a tag in a project.
gitlab_publish_repository_package OTHERTOOL Publish a repository package for a specific project.
gitlab_register_new_runner PIPELINESTOOL Register a new runner.
gitlab_require_code_owner_approvals_single_branch REPOSITORIESTOOL Require code owner approvals for a specific branch in a project.
gitlab_reset_gitlab_runner_token PIPELINESTOOL Reset GitLab runner registration token.
gitlab_reset_group_runner_token PIPELINESTOOL Reset registration token for a group's runner.
gitlab_reset_project_runner_token PROJECTSTOOL Reset registration token for a project's runner.
gitlab_reset_token OTHERTOOL Reset authentication token for a runner.
gitlab_retry_project_job PROJECTSTOOL Retry a specific job within a project.
gitlab_revert_commit REPOSITORIESTOOL Revert a commit.
gitlab_run_pipeline PIPELINESTOOL Run a pipeline for a specific project.
gitlab_run_pipeline_schedule PIPELINESTOOL Run a pipeline schedule for a specific project.
gitlab_run_project_job PROJECTSTOOL Run a specific job within a project.
gitlab_share_project PROJECTSTOOL Share a specific project with a group.
gitlab_stop_environment ENVIRONMENTSTOOL Stop an environment for a project.
gitlab_stop_stale_environments ENVIRONMENTSTOOL Stop stale environments for a project.
gitlab_take_pipeline_schedule_ownership PIPELINESTOOL Take ownership of a pipeline schedule for a specific project.
gitlab_unapprove_merge_request MERGE_REQUESTSTOOL Unapprove a specific merge request.
gitlab_unarchive_project PROJECTSTOOL Unarchive a specific project.
gitlab_unprotect_branch REPOSITORIESTOOL Unprotect a specific branch in a project.
gitlab_unprotect_environment ENVIRONMENTSTOOL Unprotect an environment for a project.
gitlab_unprotect_tag REPOSITORIESTOOL Unprotect a tag in a project.
gitlab_update_environment ENVIRONMENTSTOOL Update an existing environment for a project.
gitlab_update_epic ISSUESTOOL Update a group epic.
gitlab_update_issue ISSUESTOOL Update an issue.
gitlab_update_label ISSUESTOOL Update an existing label.
gitlab_update_milestone ISSUESTOOL Update a project milestone.
gitlab_update_note OTHERTOOL Update a note.
gitlab_update_project_level_rule PROJECTSTOOL Update an existing project-level merge request approval rule.
gitlab_update_protected_environment ENVIRONMENTSTOOL Update a protected environment for a project.
gitlab_update_release ENVIRONMENTSTOOL Update information about a release in a project.
gitlab_update_runner_details PIPELINESTOOL Update details for a specific runner.
gitlab_update_snippet OTHERTOOL Update a snippet.
gitlab_update_user USERS_GROUPSTOOL Update an existing user.
gitlab_update_wiki_page OTHERTOOL Update an existing wiki page for a project.
gitlab_upload_wiki_page_attachment OTHERTOOL Upload an attachment to a wiki page for a project.
gitlab_verify_runner_authentication PIPELINESTOOL Verify runner authentication.

34 action-routed tool(s) (default) · 196 verbose 1:1 tool(s). Each is enabled unless its TOOL toggle is set false; MCP_TOOL_MODE selects the surface (condensed default · verbose 1:1 · both). Auto-generated — do not edit.

Detailed tool schemas, parameter shapes, and validation constraints are preserved in docs/usage.md.

Dynamic Tool Selection & Visibility

This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.

The operator can configure tool filtering via multiple input channels:

  • CLI Arguments: Pass --tools or --toolsets (or their disabled counterparts --disabled-tools and --disabled-toolsets) during startup.
  • Environment Variables: Define standard environment variables:
  • MCP_ENABLED_TOOLS / MCP_DISABLED_TOOLS
  • MCP_ENABLED_TAGS / MCP_DISABLED_TAGS
  • HTTP SSE Request Headers: Pass custom headers during transport initialization:
  • x-mcp-enabled-tools / x-mcp-disabled-tools
  • x-mcp-enabled-tags / x-mcp-disabled-tags
  • HTTP SSE Request Query Parameters: Append query parameters directly to the operator's transport connection URL:
  • ?tools=tool1,tool2
  • ?tags=tag1

When query strings or parameters are supplied, an LLM-free Knowledge Graph resolution layer (using DynamicToolOrchestrator) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.


MCP Configuration Examples

> Install the connector-focused [mcp] extra. Examples use gitlab-api[mcp] to add
> FastMCP / FastAPI through agent-connector-sdk; the required Agent Connector SDK core
> still carries epistemic-graph[full]. The [agent-runtime] extra additionally
> enables model orchestration.

stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)```json

{
"mcpServers": {
"gitlab-mcp": {
"command": "uvx",
"args": [
"--from",
"gitlab-api[mcp]",
"gitlab-mcp"
],
"env": {
"MCP_TOOL_MODE": "intent",
"BRANCHESTOOL": "True",
"COMMITSTOOL": "True",
"CUSTOM_APITOOL": "True",
"DEPLOY_TOKENSTOOL": "True",
"ENVIRONMENTSTOOL": "True",
"EPICSTOOL": "True",
"GITLAB_TOKEN": "your_gitlab_token_here",
"GITLAB_URL": "https://gitlab.example.com",
"GRAPHQLTOOL": "True",
"GRAPHQL_OPSTOOL": "True",
"GROUPSTOOL": "True",
"ISSUESTOOL": "True",
"JOBSTOOL": "True",
"LABELSTOOL": "True",
"MEMBERSTOOL": "True",
"MERGE_REQUESTSTOOL": "True",
"MERGE_RULESTOOL": "True",
"MILESTONESTOOL": "True",
"MISCTOOL": "True",
"NAMESPACESTOOL": "True",
"NOTESTOOL": "True",
"PACKAGESTOOL": "True",
"PIPELINESTOOL": "True",
"PIPELINE_SCHEDULESTOOL": "True",
"PROJECTSTOOL": "True",
"PROTECTED_BRANCHESTOOL": "True",
"RELEASESTOOL": "True",
"RUNNERSTOOL": "True",
"SNIPPETSTOOL": "True",
"TAGSTOOL": "True",
"USERSTOOL": "True",
"VULNERABILITIESTOOL": "True",
"WIKITOOL": "True"
}
}
}
}


Runtime references require an alias-aware launcher such as Arbora. Other
launchers must omit those entries and inject the resolved values through their
own runtime secret boundary.

#### Streamable-HTTP Transport (networked / production)```json
{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "gitlab-api[mcp]",
        "gitlab-mcp",
        "--transport",
        "streamable-http",
        "--port",
        "8000"
      ],
      "env": {
        "TRANSPORT": "streamable-http",
        "HOST": "127.0.0.1",
        "PORT": "8000",
        "MCP_TOOL_MODE": "intent",
        "BRANCHESTOOL": "True",
        "COMMITSTOOL": "True",
        "CUSTOM_APITOOL": "True",
        "DEPLOY_TOKENSTOOL": "True",
        "ENVIRONMENTSTOOL": "True",
        "EPICSTOOL": "True",
        "GITLAB_TOKEN": "your_gitlab_token_here",
        "GITLAB_URL": "https://gitlab.example.com",
        "GRAPHQLTOOL": "True",
        "GRAPHQL_OPSTOOL": "True",
        "GROUPSTOOL": "True",
        "ISSUESTOOL": "True",
        "JOBSTOOL": "True",
        "LABELSTOOL": "True",
        "MEMBERSTOOL": "True",
        "MERGE_REQUESTSTOOL": "True",
        "MERGE_RULESTOOL": "True",
        "MILESTONESTOOL": "True",
        "MISCTOOL": "True",
        "NAMESPACESTOOL": "True",
        "NOTESTOOL": "True",
        "PACKAGESTOOL": "True",
        "PIPELINESTOOL": "True",
        "PIPELINE_SCHEDULESTOOL": "True",
        "PROJECTSTOOL": "True",
        "PROTECTED_BRANCHESTOOL": "True",
        "RELEASESTOOL": "True",
        "RUNNERSTOOL": "True",
        "SNIPPETSTOOL": "True",
        "TAGSTOOL": "True",
        "USERSTOOL": "True",
        "VULNERABILITIESTOOL": "True",
        "WIKITOOL": "True"
      }
    }
  }
}

Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:```json
{
"mcpServers": {
"gitlab-mcp": {
"url": "http://localhost:8000/gitlab-mcp/mcp"
}
}
}


Run a reviewed container image as a least-privilege stdio child (no
listener or published port):```bash
docker run -i --rm \
  --read-only \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --pids-limit=256 \
  --tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
  -e TRANSPORT=stdio \
  -e MCP_TOOL_MODE=intent \
  -e BRANCHESTOOL=True \
  -e COMMITSTOOL=True \
  -e CUSTOM_APITOOL=True \
  -e DEPLOY_TOKENSTOOL=True \
  -e ENVIRONMENTSTOOL=True \
  -e EPICSTOOL=True \
  -e GITLAB_TOKEN=your_gitlab_token_here \
  -e GITLAB_URL=https://gitlab.example.com \
  -e GRAPHQLTOOL=True \
  -e GRAPHQL_OPSTOOL=True \
  -e GROUPSTOOL=True \
  -e ISSUESTOOL=True \
  -e JOBSTOOL=True \
  -e LABELSTOOL=True \
  -e MEMBERSTOOL=True \
  -e MERGE_REQUESTSTOOL=True \
  -e MERGE_RULESTOOL=True \
  -e MILESTONESTOOL=True \
  -e MISCTOOL=True \
  -e NAMESPACESTOOL=True \
  -e NOTESTOOL=True \
  -e PACKAGESTOOL=True \
  -e PIPELINESTOOL=True \
  -e PIPELINE_SCHEDULESTOOL=True \
  -e PROJECTSTOOL=True \
  -e PROTECTED_BRANCHESTOOL=True \
  -e RELEASESTOOL=True \
  -e RUNNERSTOOL=True \
  -e SNIPPETSTOOL=True \
  -e TAGSTOOL=True \
  -e USERSTOOL=True \
  -e VULNERABILITIESTOOL=True \
  -e WIKITOOL=True \
  registry.example.invalid/gitlab-api@sha256:<digest> gitlab-mcp

For containerized network HTTP, supply an authenticated TLS ingress (or
direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy

…(正文过长,页面只展示前面部分,完整内容见仓库)

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
gitlab-api 怎么安装?

在客户端按下面的安装命令接入:pip install gitlab-api。对应的包名是 gitlab-api。装完在客户端配置里引用同一个包或端点。

gitlab-api 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

gitlab-api 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

gitlab-api 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

gitlab-api 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

gitlab-api 能提供哪些能力?

资料显示能力标签包括 a2a、a2a-server、ag-ui、api、gitlab-api。具体工具清单以官方文档为准。

gitlab-api 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

gitlab-api 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-20。