Gitee MCP Server

Gitee MCP 服务

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

功能

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

实用场景：从仓库获取问题、实现功能并创建拉取请求

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

安装

远程 MCP 服务无需安装，开箱即用。如需在本地运行 mcp-gitee（stdio），请从以下选项中选择一种。

远程 MCP 服务（推荐）

将以下内容添加到主机配置的 mcpServers 部分，并将 <your personal access token> 替换为从此处获取的令牌：

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

有关各客户端的配置文件路径和格式（Claude Code、Codex、Cursor、Trae、Cline、Continue、opencode），请参阅下方 MCP 主机配置部分中链接的指南。

本地（stdio）

下载预构建二进制文件

从 Releases 下载适用于你平台的压缩包（linux-amd64 / linux-arm / darwin-amd64 / darwin-arm64 / windows-amd64），解压后将 mcp-gitee 放入 PATH（Windows 上的可执行文件为 mcp-gitee.exe）。

使用 npx

无需安装；启动时会自动下载适用于你平台的预构建二进制文件：

{
  "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>"
      }
    }
  }
}

从源代码构建

需要 Go 1.23.0 或更高版本。

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

使用已安装的可执行文件

通过 Releases、源代码构建或 go install 将 mcp-gitee 加入 PATH 后：

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

Windows：可执行文件必须包含 .exe 后缀，且 command 中的路径应使用正斜杠 /（Windows 支持正斜杠，并且可以避免 JSON 反斜杠转义错误）：

{
  "mcpServers": {
    "gitee": {
      "command": "C:/Users/<you>/bin/mcp-gitee.exe",
      "env": {
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

MCP 主机配置

配置示例：点击查看更多应用配置

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

命令行选项

• --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：要禁用的工具列表，以逗号分隔

工具集管理

工具集管理支持两种模式：

1. 启用指定工具（白名单模式）：

   • 使用 --enabled-toolsets 参数或 ENABLED_TOOLSETS 环境变量
   • 指定后，仅启用列出的工具，其他工具将被禁用
   • 示例：--enabled-toolsets="list_user_repos,get_file_content"

2. 禁用指定工具（黑名单模式）：

   • 使用 --disabled-toolsets 参数或 DISABLED_TOOLSETS 环境变量
   • 指定后，列出的工具将被禁用，其他工具将被启用
   • 示例：--disabled-toolsets="list_user_repos,get_file_content"

注意：

• 如果同时指定了 enabled-toolsets 和 disabled-toolsets，则以 enabled-toolsets 为准
• 工具名称区分大小写

按请求筛选工具（HTTP 标头）

使用远程 MCP 服务（HTTP/SSE 传输）时，可以通过 HTTP 标头按请求动态筛选可用工具。对于需要精细控制工具开放范围、又不想重启服务的客户端，这一功能很有用。

1. 通过标头启用指定工具（白名单）：

   • 使用 X-MCP-Enabled-Tools 标头
   • 该请求仅启用列出的工具
   • 示例：X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. 通过标头禁用指定工具（黑名单）：

   • 使用 X-MCP-Disabled-Tools 标头
   • 该请求将禁用列出的工具
   • 示例：X-MCP-Disabled-Tools: create_repo,delete_repo

优先级规则：

• 如果同一请求中同时包含 X-MCP-Enabled-Tools 和 X-MCP-Disabled-Tools，则以白名单（X-MCP-Enabled-Tools）为准
• 工具名称区分大小写

Cursor/Claude 配置示例：

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

许可证

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

可用工具

工具	类别	描述
list_user_repos	仓库	列出用户已授权的仓库
get_file_content	仓库	获取仓库中文件的内容
create_repo	仓库	创建仓库（用户、组织或企业）
fork_repository	仓库	复刻仓库
create_release	仓库	为仓库创建一个发行版本
list_releases	仓库	列出仓库的发行版本
search_open_source_repositories	仓库	在 Gitee 上搜索开源仓库
search_files_by_content	仓库	根据内容搜索仓库中的文件
compare_branches_tags	仓库	比较仓库中的两个分支、标签或提交
list_repo_pulls	拉取请求	列出仓库中的拉取请求
merge_pull	拉取请求	合并拉取请求
create_pull	拉取请求	创建拉取请求
update_pull	拉取请求	更新拉取请求
get_pull_detail	拉取请求	获取拉取请求的详细信息
get_diff_files	拉取请求	获取拉取请求的差异文件
manage_pull_review	拉取请求	管理拉取请求的评审（批准或取消）
create_comment	评论	在议题或拉取请求中创建评论
list_comments	评论	列出议题或拉取请求的所有评论
create_issue	议题	创建议题
update_issue	议题	更新议题
get_repo_issue_detail	议题	获取仓库议题的详细信息
list_repo_issues	议题	列出仓库议题
get_user_info	用户	获取当前已认证用户的信息
search_users	用户	搜索用户
list_user_notifications	通知	列出用户通知

贡献

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

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

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