Gitee MCP

Gitee MCP Server 是 Gitee 官方提供的 MCP 服务,用于让 AI 助手通过 Gitee API 访问和管理仓库、Issue、Pull Request、通知等协作数据。

官方文档:https://help.gitee.com/ai-productivity/mcp-server

适用场景

根据 Gitee Issue 读取需求并生成修改计划。
读取 Pull Request 详情、评论和差异文件,辅助 review。
查询仓库文件、分支、release 和开源仓库信息。
在 Gitee 社区版、企业版或私有化实例中接入 AI 客户端。
让 Agent 在受控权限内创建 Issue、评论 PR 或整理通知。

功能特点

Gitee 官方文档列出的能力重点包括:

与 Gitee 仓库、Issue、Pull Request 和通知交互。
支持配置 API 基础 URL,可接入不同 Gitee 实例。
支持个人、组织和企业操作。
支持通过命令行参数或环境变量配置。
支持动态启用或禁用工具集。

前提条件

Gitee 账号。
Gitee 个人访问令牌。
使用 npx 方式时需要 Node.js 与 npm。
从源码构建或使用 Go 安装时需要 Go 1.23.0 或更高版本。

访问令牌获取入口:

https://gitee.com/profile/personal_access_tokens

推荐配置:npx 启动

适合大多数本地 AI 客户端,无需先安装可执行文件:

json

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Remote Server

官方 remote server 地址:

text

https://api.gitee.com/mcp

如果客户端支持 remote MCP,可优先评估这种方式。具体认证方式以客户端和 Gitee 官方文档为准。

可执行文件启动

如果已经安装 mcp-gitee,可使用:

json

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

命令行参数

常用参数:

参数	说明
`--token`	Gitee 访问令牌
`--api-base`	Gitee API 基础 URL,默认 `https://gitee.com/api/v5`
`--version`	显示版本信息
`--transport`	传输类型,可选 `stdio`、`sse`、`http`,默认 `stdio`
`--address`	服务监听地址,默认 `localhost:8000`
`--enabled-toolsets`	逗号分隔的启用工具列表
`--disabled-toolsets`	逗号分隔的禁用工具列表

环境变量

变量	说明
`GITEE_ACCESS_TOKEN`	Gitee 访问令牌
`GITEE_API_BASE`	Gitee API 基础 URL
`ENABLED_TOOLSETS`	逗号分隔的启用工具列表
`DISABLED_TOOLSETS`	逗号分隔的禁用工具列表

企业版或私有化实例应把 GITEE_API_BASE 改为对应实例的 API 地址。

工具集控制

Gitee MCP 支持两种工具集控制方式:

白名单模式:使用 --enabled-toolsets 或 ENABLED_TOOLSETS,指定后只启用列出的工具。
黑名单模式:使用 --disabled-toolsets 或 DISABLED_TOOLSETS,指定后禁用列出的工具,其他工具保持启用。

如果同时指定 enabled 和 disabled,以 enabled 优先。工具名称区分大小写。

可用工具范围

官方文档列出的工具覆盖这些类别:

仓库:列出仓库、读取文件、创建仓库、Fork、创建 release、搜索开源仓库。
Pull Request:列出、创建、更新、合并、查看详情、评论、读取评论、获取差异文件。
Issue:创建、更新、查看详情、列出、评论、读取评论。
用户:获取当前认证用户信息、搜索用户。
通知:列出用户通知。

安全建议

访问令牌只授予必要权限。
优先从只读工具集开始,确认行为后再开放写入能力。
对创建、更新、合并、评论等写操作,要求 Agent 先列计划并等待确认。
私有化实例不要把生产令牌写进仓库文件。
定期轮换 Token,离职或权限变化时及时回收。

Gitee MCP ​

适用场景 ​

功能特点 ​

前提条件 ​

推荐配置:npx 启动 ​

Remote Server ​

可执行文件启动 ​

命令行参数 ​

环境变量 ​

工具集控制 ​

可用工具范围 ​

安全建议 ​

相关文档 ​