Gitee 服务 MCP 接入

通过 MCP 协议提供 Gitee 服务调用，支持代码评审，文件操作、仓库管理、搜索功能等。

前往云开发平台 MCP Server

---

环境变量

• 需要将 GITEE_PERSONAL_ACCESS_TOKEN 配置为您在Gitee 上创建的 私人令牌

使用说明

Gitee MCP Server 参考文档

🗺️ 功能清单

工具标识	功能描述	核心参数
create_or_update_file	创建或更新单个文件	owner, repo, path, content, message
push_files	单次提交推送多个文件	owner, repo, branch, files, message
create_repository	创建新Gitee仓库	name, description, private
get_file_contents	获取文件或目录内容	owner, repo, path, branch
create_issue	创建新issue	owner, repo, title, body, assignees
create_pull_request	创建新PR	owner, repo, title, head, base
fork_repository	Fork仓库	owner, repo, organization
create_branch	创建新分支	owner, repo, branch_name, refs
list_branches	列出仓库分支	owner, repo, sort, direction
get_branch	获取特定分支信息	owner, repo, branch
list_issues	列出和筛选仓库issues	owner, repo, state, labels
update_issue	更新现有issue	owner, repo, issue_number, title
add_issue_comment	添加issue评论	owner, repo, issue_number, body
get_issue	获取issue内容	owner, repo, issue_number
get_pull_request	获取特定PR详情	owner, repo, pull_number
list_pull_requests	列出和筛选仓库PR	owner, repo, state
merge_pull_request	合并PR	owner, repo, pull_number, merge_method
update_pull_request	更新PR	owner, repo, pull_number, title
get_user	获取指定用户信息	username
get_current_user	获取当前认证用户信息	-

仓库地址

https://gitee.com/oschina/mcp-gitee

---

🔌 使用方式

• 在云开发 Agent 中使用
• 在 MCP Host 中使用
• 通过 SDK 接入

---

云开发 MCP 控制台

参数说明

create_or_update_file

在仓库中创建或更新单个文件

输入参数	Type	描述
owner	string	仓库所有者(用户名或组织)
repo	string	仓库名称
path	string	文件创建/更新的路径
content	string	文件内容
message	string	提交信息
branch	string	操作的目标分支
sha	optional string	被替换文件的SHA(用于更新)

返回: 文件内容和提交详情

push_files

在单次提交中推送多个文件

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
branch	string	推送目标分支
files	array	要推送的文件数组(每个包含路径和内容)
message	string	提交信息

返回: 更新后的分支引用

create_repository

创建新Gitee仓库

输入参数	Type	描述
name	string	仓库名称
description	optional string	仓库描述
homepage	optional string	homepage url
private	optional boolean	是否私有仓库
autoInit	optional boolean	是否初始化README

返回: 创建的仓库详情

get_file_contents

获取文件或目录内容

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
path	string	文件/目录路径
branch	optional string	获取内容的分支

返回: 文件/目录内容

create_issue

创建新issue

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
title	string	issue标题
body	optional string	issue描述
assignees	optional string[]	分配的用户名
labels	optional string[]	添加的标签
milestone	optional number	里程碑编号

返回: 创建的issue详情

create_pull_request

创建新PR

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
title	string	PR标题
body	optional string	PR描述
head	string	包含更改的分支
base	string	要合并到的目标分支
labels	optional string[]	添加的标签
milestone_number	optional number	里程碑编号
assignees	optional string[]	分配的用户名

返回: 创建的PR详情

fork_repository

Fork仓库

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
organization	optional string	Fork到的组织

返回: Fork后的仓库详情

create_branch

创建新分支

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
branch_name	string	新分支名称
refs	optional string	源分支(默认为仓库默认分支)

返回: 创建的分支引用

list_branches

列出 Gitee 仓库中的分支

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
sort	optional string	排序方式('created', 'updated', 'comments')
direction	optional string	排序方向('asc', 'desc')
page	optional number	页码
per_page	optional number	每页结果数

返回: Gitee 仓库中的分支

get_branch

获取 Gitee 仓库中的特定分支信息

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
branch	string	新分支名称

返回: Gitee 仓库中的特定分支信息

list_issues

列出和筛选仓库issues

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
state	optional string	状态筛选('open', 'closed', 'all')
labels	optional string	标签筛选 (多标签用逗号隔开)
sort	optional string	排序方式('created', 'updated', 'comments')
direction	optional string	排序方向('asc', 'desc')
page	optional number	页码
per_page	optional number	每页结果数
milestone	optional number	里程碑编号
assignees	optional string[]	分配的用户名

返回: issue详情数组

update_issue

更新现有issue

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
issue_number	number	要更新的issue编号
title	optional string	新标题
body	optional string	新描述
state	optional string	新状态('open'或'closed')
labels	optional string[]	新标签
assignees	optional string[]	新分配者
milestone	optional number	新里程碑编号

返回: 更新后的issue详情

add_issue_comment

添加issue评论

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
issue_number	number	要评论的issue编号
body	string	评论内容

返回: 创建的评论详情

get_issue

获取仓库中某个issue的内容

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
issue_number	number	要获取的issue编号

返回: Gitee Issue对象及详情

get_pull_request

获取特定PR的详情

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
pull_number	number	PR编号

返回: 包含diff和审查状态的PR详情

list_pull_requests

列出和筛选仓库PR

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
state	optional string	状态筛选('open', 'closed', 'all')
sort	optional string	排序方式('created', 'updated', 'popularity', 'long-running')
direction	optional string	排序方向('asc', 'desc')
per_page	optional number	每页结果数(最大100)
page	optional number	页码
labels	optional string	标签筛选 (多标签用逗号隔开)
milestone	optional number	新里程碑编号

返回: PR详情数组

merge_pull_request

合并PR

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
pull_number	number	PR编号
merge_method	optional string	合并方式('merge', 'squash', 'rebase')

update_pull_request

更新 Gitee 仓库中的 Pull Request

输入参数	Type	描述
owner	string	仓库所有者
repo	string	仓库名称
pull_number	number	PR编号
title	string	PR标题
body	optional string	PR描述
milestone_number	optional number	里程碑编号
state	optional string	新状态('open'或'closed')
labels	optional string[]	新标签
assignees	optional string[]	新分配者

返回: 合并结果详情

get_user

输入参数	Type	描述
username	string	用户名

返回: gitee用户信息

get_current_user

返回: 获取当前认证的 Gitee 用户信息