Gitee MCP 服务器

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

功能特性

与 Gitee 仓库、议题、拉取请求和通知进行交互
可配置的 API 基础 URL，支持不同的 Gitee 实例
便于配置的命令行参数
支持个人、组织和企业操作
动态启用/禁用工具集

实际场景示例：从仓库获取议题、实现代码并创建拉取请求

获取仓库议题
根据议题详情实现代码并创建拉取请求
评论并关闭议题

安装（使用 npx 启动时可直接跳过此步骤）

前提条件

Go 1.23.0 或更高版本
带有访问令牌的 Gitee 账户，获取方式

从源代码构建

克隆仓库：

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

构建项目：
```
make build
```
将 ./bin/mcp-gitee 添加到 PATH 环境变量中

使用 go install

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

使用方法

检查 mcp-gitee 版本：

mcp-gitee --version

MCP 主机配置

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

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<你的个人访问令牌>"
      }
    }
  }
}

可执行文件

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<你的个人访问令牌>"
      }
    }
  }
}

命令行选项

--token：Gitee 访问令牌
--api-base：Gitee API 基础 URL（默认：https://gitee.com/api/v5）
--version：显示版本信息
--transport：传输类型（stdio 或 sse，默认：stdio）
--sse-address：启动 SSE 服务器的主机和端口（默认：localhost:8000）
--enabled-toolsets：以逗号分隔的要启用的工具列表（如果指定，则仅启用这些工具）
--disabled-toolsets：以逗号分隔的要禁用的工具列表

环境变量

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

GITEE_ACCESS_TOKEN：Gitee 访问令牌
GITEE_API_BASE：Gitee API 基础 URL
ENABLED_TOOLSETS：以逗号分隔的要启用的工具列表
DISABLED_TOOLSETS：以逗号分隔的要禁用的工具列表

工具集管理

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

启用指定工具（白名单模式）：
- 使用 --enabled-toolsets 参数或 ENABLED_TOOLSETS 环境变量
- 指定后，仅启用列出的工具，其他工具将被禁用
- 示例：--enabled-toolsets="list_user_repos,get_file_content"
禁用指定工具（黑名单模式）：
- 使用 --disabled-toolsets 参数或 DISABLED_TOOLSETS 环境变量
- 指定后，列出的工具将被禁用，其他工具将被启用
- 示例：--disabled-toolsets="list_user_repos,get_file_content"

注意：

如果同时指定了 enabled-toolsets 和 disabled-toolsets，enabled-toolsets 优先
工具名称区分大小写

许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

可用工具

服务器提供各种与 Gitee 交互的工具：

工具	类别	描述
list_user_repos	仓库	列出用户授权的仓库
get_file_content	仓库	获取仓库中文件的内容
create_user_repo	仓库	创建用户仓库
create_org_repo	仓库	创建组织仓库
create_enter_repo	仓库	创建企业仓库
fork_repository	仓库	叉取仓库
create_release	仓库	为仓库创建发布
list_releases	仓库	列出仓库发布
search_open_source_repositories	仓库	在 Gitee 上搜索开源仓库
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	用户	获取当前认证用户信息
search_users	用户	搜索用户
list_user_notifications	通知	列出用户通知

贡献

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

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

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