返回 MCP 目录
public公开dns本地运行

gitlab-mcp-zed

这是一个为Zed编辑器提供的GitLab MCP服务器扩展,支持GitLab项目管理和文件操作,可连接gitlab.com或自托管实例,需配置个人访问令牌实现认证。

article

README

🚀 GitLab MCP 服务器扩展用于 Zed

这是一个专为 Zed 编辑器打造的扩展,它集成了 GitLab 的 Model Context Protocol (MCP) 服务器,具备项目管理、文件操作等实用功能,能显著提升你在 Zed 中使用 GitLab 的效率。

🚀 快速开始

此扩展为 Zed 编辑器集成了 GitLab 的 MCP 服务器,让你在 Zed 中就能轻松进行项目管理和文件操作。

✨ 主要特性

  • GitLab 集成:与 GitLab API 无缝对接,支持项目管理和文件操作。
  • 可选 API URL:既支持 gitlab.com,也支持自托管的 GitLab 实例。
  • 自动认证:通过个人访问令牌自动处理 GitLab 认证。

📦 安装指南

前往:Zed > 扩展 或使用命令面板(macOSLinux)搜索 extensions

📚 详细文档

配置

必填设置

在你的 settings.json 中配置以下内容:

{
  "context_server": {
    "mcp-server-gitlab": {
      "settings": {
        "gitlab_personal_access_token": "YOUR_TOKEN"
      }
    }
  }
}

可选设置

对于自托管的 GitLab 实例,可以指定自定义 API URL:

{
  "context_server": {
    "mcp-server-gitlab": {
      "settings": {
        "gitlab_personal_access_token": "YOUR_TOKEN",
        "gitlab_api_url": "https://your-gitlab-instance.com/api/v4"
      }
    }
  }
}

代理模式配置

如果你使用 Zed 的代理模式,需要为你的助理启用此上下文服务器:

  1. 打开 Zed 的代理设置。
  2. 启用 GitLab MCP 服务器。如果你看到工具状态是一个红点,请确保你已在 settings.json 中添加了 gitlab_personal_access_token。
  3. 在活动的代理配置文件中启用 GitLab MCP 服务器。在聊天部分,点击 Write | Ask 按钮,然后点击 tools,启用 GitLab MCP 服务器。

个人访问令牌

创建 GitLab 个人访问令牌:

  1. 转到 GitLab 用户设置 > 访问令牌。
  2. 选择所需的范围:
    • api 获取完整的 API 访问权限。
    • read_api 读取-only 访问权限。
    • read_repositorywrite_repository 用于仓库操作。
  3. 创建令牌并安全保存。
  4. 按照上述所示将令牌添加到 Zed 设置中。

从源代码构建

  1. 确保你已安装 Rust 和 Cargo。
  2. 克隆仓库。
  3. 运行 cargo build --release

📄 许可证

本项目采用 Apache-2.0 许可证。

🌟 贡献

欢迎大家积极贡献!请随时提交拉取请求。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端