Gitee MCP Server

Gitee MCP Server

site icon
2025.04.14 0
Go代码托管版本控制协作开发交流协作
Gitee MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于与 Gitee 平台进行交互。它提供了一系列工具,使 AI 助手能够管理仓库、问题、拉取请求等。该服务支持个人、组织和企业级别的操作,并可通过命令行或环境变量进行配置。
View on GitHub

Overview

基本能力

产品定位

Gitee MCP Server 是一个用于与 Gitee 平台交互的 MCP 服务器实现,旨在帮助 AI 助手管理 Gitee 上的仓库、问题、拉取请求等。

核心功能

  • 与 Gitee 仓库、问题、拉取请求和通知进行交互
  • 可配置的 API 基础 URL,支持不同的 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 通知 列出用户通知

常见问题解答

  • 如何获取 Gitee 访问令牌? 访问 https://gitee.com/profile/personal_access_tokens 获取个人访问令牌。
  • 如何配置 API 基础 URL? 使用 -api-base 命令行选项或设置 GITEE_API_BASE 环境变量。

使用教程

使用依赖

  • Go 1.23.0 或更高版本
  • 具有访问令牌的 Gitee 账户

安装教程

  1. 克隆仓库: bash git clone https://gitee.com/oschina/mcp-gitee.git cd mcp-gitee
  2. 构建项目: bash make build 将 ./bin/mcp-gitee 移动到 PATH 环境变量中

或者使用 go install: bash go install gitee.com/oschina/mcp-gitee@latest

调试方式

检查 mcp-gitee 版本:

mcp-gitee --version

配置示例(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 开源许可条款,请参阅 MIT 了解完整条款。