关键词

Gitee Enterprise代码管理议题跟踪合并请求团队协作

项目简介

Gitee Enterprise MCP 服务器是 Model Context Protocol (MCP) 的一个实现，专门用于连接和操作 Gitee Enterprise 平台。它将 Gitee Enterprise 的各种功能（如仓库管理、议题跟踪、合并请求处理等）封装成 MCP 工具，供支持 MCP 协议的 LLM 客户端（如 AI 助手）调用。

主要功能点

  • 通过标准化的 MCP 工具与 Gitee Enterprise API 交互。
  • 支持管理企业级代码仓库（列出、创建、发布）。
  • 支持管理议题（列出、创建、更新、获取详情、评论）。
  • 支持管理合并请求（列出、创建、更新、获取详情、获取 Diff、评论、合并）。
  • 支持获取企业、用户、成员、群组、标签、项目集、冲刺、版本等信息。
  • 支持 Stdio 和 SSE 两种传输协议。
  • 支持动态启用/禁用特定工具集。
  • 通过访问令牌进行身份验证。

安装步骤

  1. 安装 Go 环境: 确保您的系统已安装 Go 1.23.0 或更高版本。可以从 Go 官方网站 下载安装包。
  2. 获取 Gitee Enterprise MCP 访问令牌: 访问 https://gitee.com/profile/mcp_gitee_ent_access_tokens 获取所需的访问令牌。
  3. 安装服务器: 打开终端，运行以下命令使用 'go install' 安装服务器程序： 
    go install gitee.com/oschina/mcp-gitee-ent@latest
    这会将可执行文件 'mcp-gitee-ent' 安装到您的 Go bin 路径下。请确保 Go bin 路径已添加到系统的 PATH 环境变量中。

服务器配置

MCP 服务器由 MCP 客户端（如某些 AI 助手或 IDE 插件）负责启动和管理。您需要在客户端的 MCP 配置中指定启动此服务器的命令及其参数。典型的配置信息（通常是 JSON 格式）包含服务器名称、启动命令以及传递给服务器的环境变量或命令行参数。

核心配置项通常包括：

  • 'command': 启动 'mcp-gitee-ent' 服务器的可执行文件路径或名称（如果已在 PATH 中）。
  • 'env' 或 'args': 用于向服务器传递配置信息，特别是 Gitee Enterprise MCP 访问令牌 和 Gitee Enterprise API 基础 URL。建议使用环境变量传递敏感信息。

配置示例说明（请根据您使用的 MCP 客户端的具体配置格式进行调整）：

  • 您需要配置一个名为例如 'gitee' 的 MCP 服务器。
  • 该服务器的启动命令应指向 'mcp-gitee-ent'。
  • 必须通过环境变量 'GITEE_ENT_MCP_ACCESS_TOKEN' 或命令行参数 '-token' 提供您的访问令牌。
  • 可以通过环境变量 'GITEE_ENT_API_BASE' 或命令行参数 '-api-base' 指定 Gitee Enterprise API 的基础 URL（默认为 'https://api.gitee.com/enterprises'）。
  • 可以通过环境变量 'ENABLED_TOOLSETS'/'DISABLED_TOOLSETS' 或命令行参数 '--enabled-toolsets'/'--disabled-toolsets' 控制启用的工具集。
  • 可以通过命令行参数 '-transport' 和 '-sse-address' 配置传输方式（默认为 stdio）。

这些配置信息使得 MCP 客户端能够在需要时正确地启动和连接到此 Gitee Enterprise MCP 服务器，并与其进行通信。

基本使用方法

该 MCP 服务器本身作为一个后台进程运行，不提供直接的用户界面。其功能通过 MCP 客户端集成到 AI 助手或其他应用中进行调用。

配置完成后，您的 MCP 客户端（例如，集成了 MCP 支持的 IDE 插件或 AI 应用）将能够：

  1. 发现此 'mcp-gitee-ent' 服务器提供的工具能力（即上文提到的各种 Gitee Enterprise 操作）。
  2. 根据用户的请求，通过 MCP 协议调用这些工具，例如“列出我的议题”、“创建一个新的合并请求”等。
  3. 接收并向用户展示工具执行的结果或错误信息。

您只需确保服务器已正确安装，访问令牌有效，并在您的 MCP 客户端中完成了相应的配置即可。

信息

分类

开发者工具

访问项目