Gitee

Gitee MCP 服务

Gitee MCP 服务是 Gitee 的模型上下文协议（MCP）服务实现。它提供一组用于与 Gitee API 交互的工具，便于 AI 助手管理仓库、议题、拉取请求等。

功能

• 与 Gitee 仓库、议题、拉取请求和通知交互
• 可配置 API 基础 URL，以支持不同的 Gitee 实例
• 提供命令行标志，便于配置
• 支持个人、组织和企业操作

实际场景：获取仓库中的议题、实现并创建拉取请求

1. 获取仓库议题
2. 根据议题详情编写代码并创建拉取请求
3. 评论并关闭议题

安装

先决条件

• Go 1.23.0 或更高版本
• 拥有访问令牌的 Gitee 账号，前往获取

从源代码构建

1. 克隆仓库：

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee
   

2. 构建项目：

   make build
   

   将 ./bin/mcp-gitee 移动到 PATH 环境变量中

使用 go install

go install gitee.com/oschina/mcp-gitee@latest

使用

检查 mcp-gitee 版本：

mcp-gitee --version

MCP 宿主配置

Cursor、Windsurf 配置示例：

{
  "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，默认值：stdio）
• -sse-address：启动 SSE 服务的主机和端口（默认值：localhost:8000）

环境变量

也可以使用环境变量配置服务：

• GITEE_ACCESS_TOKEN：Gitee 访问令牌
• GITEE_API_BASE：Gitee API 基础 URL

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

可用工具

服务器提供了多种用于与 Gitee 交互的工具：

工具	类别	描述
list_user_repos	仓库	列出用户已授权的仓库
get_file_content	仓库	获取仓库中文件的内容
create_user_repo	仓库	创建用户仓库
create_org_repo	仓库	创建组织仓库
create_enter_repo	仓库	创建企业仓库
create_release	仓库	为仓库创建发行版本
list_releases	仓库	列出仓库的发行版本
list_repo_pulls	Pull Request	列出仓库中的拉取请求
merge_pull	Pull Request	合并拉取请求
create_pull	Pull Request	创建拉取请求
update_pull	Pull Request	更新拉取请求
get_pull_detail	Pull Request	获取拉取请求的详情
comment_pull	Pull Request	对拉取请求发表评论
list_pull_comments	Pull Request	列出拉取请求的所有评论
create_issue	Issue	创建议题
update_issue	Issue	更新议题
get_repo_issue_detail	Issue	获取仓库议题的详情
list_repo_issues	Issue	列出仓库议题
comment_issue	Issue	对议题发表评论
list_issue_comments	Issue	列出议题评论
get_user_info	User	获取当前已认证用户的信息
list_user_notifications	Notification	列出用户通知

贡献

我们欢迎开源社区贡献！如果你想为此项目做出贡献，请遵循以下指南：

1. Fork 此仓库。
2. 为你的功能或错误修复创建一个新分支。
3. 进行更改，并确保代码文档齐全。
4. 提交拉取请求，并清晰描述你的更改。

如需了解更多信息，请参阅 CONTRIBUTING 文件。