M

MCP Gitee 项目管理工具

@oschina/mcp-gitee
1 Stars 432 次浏览 二十八画生 更新于 2026-08-23

Gitee API集成、仓库管理、问题跟踪、拉取请求管理等。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_ACCESS_TOKEN": "\u003cyour personal access token\u003e",
        "GITEE_API_BASE": "https://gitee.com/api/v5"
      }
    }
  }
}

该服务需要配置环境变量:GITEE_ACCESS_TOKEN、GITEE_API_BASE

服务介绍

Gitee MCP 服务器

Gitee MCP 服务器是为 Gitee 实现的 Model Context Protocol (MCP) 服务器。它提供了一组工具,用于与 Gitee 的 API 进行交互,允许 AI 助手管理仓库、问题、拉取请求等。

特性

  • 与 Gitee 仓库、问题、拉取请求和通知进行交互
  • 可配置的 API 基础 URL 以支持不同的 Gitee 实例
  • 命令行标志便于配置
  • 支持个人、组织和企业操作
  1. 获取仓库中的问题
    get_repo_issues
  2. 根据问题详情实现编码并创建拉取请求
    implement_issue
  3. 评论并关闭问题
    comment_and_close_issue

安装

前提条件

  • 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 主机配置

CursorWindsurf 配置示例:

{
  "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 拉取请求 列出仓库中的拉取请求
merge_pull 拉取请求 合并拉取请求
create_pull 拉取请求 创建拉取请求
update_pull 拉取请求 更新拉取请求
get_pull_detail 拉取请求 获取拉取请求的详情
comment_pull 拉取请求 对拉取请求进行评论
list_pull_comments 拉取请求 列出所有对拉取请求的评论
create_issue 问题 创建一个问题
update_issue 问题 更新一个问题
get_repo_issue_detail 问题 获取仓库问题的详情
list_repo_issues 问题 列出仓库的问题
comment_issue 问题 对问题进行评论
list_issue_comments 问题 列出对问题的所有评论
get_user_info 用户 获取当前认证用户的信息
list_user_notifications 通知 列出用户的通知

贡献

我们欢迎来自开源社区的贡献!如果您想为此项目做贡献,请遵循以下指南:

  1. 分叉仓库。
  2. 为您的功能或错误修复创建一个新的分支。
  3. 进行更改,并确保代码有良好的文档。
  4. 提交一个带有清晰描述您所做更改的拉取请求。

有关更多信息,请参阅 CONTRIBUTING 文件。