Gitee MCP Server

Gitee MCP Server 是一个 Gitee 的模型上下文协议 (MCP) 服务器实现。它提供了一套与 Gitee API 交互的工具，允许 AI 助手管理仓库、Issue、Pull Request 等。

功能特性

• 与 Gitee 仓库、Issue、Pull Request 和通知进行交互

• 可配置的 API 基础 URL，支持不同的 Gitee 实例

• 命令行参数，方便配置

• 支持个人、组织和企业操作

• 动态启用/禁用工具集

1. 获取仓库 Issue

2. 根据 Issue 详情进行编码并创建 Pull Request

3. 评论并关闭 Issue

Related MCP server: Gitea MCP Tool

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

前置条件

• 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 客户端配置

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

• 连接到官方远程 mcp-gitee 服务器（无需安装）

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

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

• 可执行文件

{
  "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 或 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 优先级更高

• 工具名称区分大小写

许可证

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

可用工具

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

贡献

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

1. Fork 本仓库。

2. 为您的功能或 Bug 修复创建一个新分支。

3. 进行更改并确保代码有良好的文档记录。

4. 提交一个包含清晰更改描述的 Pull Request。

更多信息，请参考 CONTRIBUTING 文件。