# @gitee/mcp-gitee 中文文档

规范地址：https://npmcn.com/package/%40gitee/mcp-gitee/

版本：1\.0\.0
npm 元数据更新时间：2026-04-23T08:52:54.717Z
中文译文更新时间：2026-11-16T12:47:59.849Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gitee/mcp-gitee
原文对照：https://npmcn.com/package/%40gitee/mcp-gitee/?lang=original
项目主页：https://gitee.com/oschina/mcp-gitee#readme
源码仓库：https://gitee.com/oschina/mcp-gitee

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：10.9 kB，4 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2025-04-24T09:10:49.103Z
- 最新版本发布：2026-04-23T08:52:54.566Z
- 近 30 天下载量：2411（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 4 个）

## 中文简介

Gitee 的模型上下文协议服务器

## 安装

```sh
npm install @gitee/mcp-gitee
```

也可以使用：`pnpm add @gitee/mcp-gitee`、`yarn add @gitee/mcp-gitee`、`bun add @gitee/mcp-gitee`

## README

# Gitee MCP 服务器

Gitee MCP Server是Gitee的一种模式上下文协议(MCP)服务器执行. 它提供了一套与Gitee的API互动的工具,允许AI助手管理寄存器,问题,拉出请求等.

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=gitee&config=eyJ1cmwiOiJodHRwczovL2FwaS5naXRlZS5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIDx5b3VyIHBlcnNvbmFsIGFjY2VzcyB0b2tlbj4ifX0%3D)

## 特征

-   与Gitee寄存器、问题、调取请求和通知进行互动
-   支持不同 Gitee 实例的配置 API 基础 URL
-   易于配置的命令行旗
-   支持个人、组织和企业业务
-   动态工具集启用/失效

**实际情景:从存储处获取问题,执行和创建拉出请求**

1.  获取仓库问题 ![get\_repo\_issues](https://npmcn.com/package/%40gitee/mcp-gitee/docs/images/get_repo_issues.jpg)
2.  根据问题细节执行编码并创建 Pull 请求 ![implement\_issue](https://npmcn.com/package/%40gitee/mcp-gitee/docs/images/implement_issue.jpg)
3.  注释关闭问题( C) ![comment\_and\_close\_issue](https://npmcn.com/package/%40gitee/mcp-gitee/docs/images/comment_and_close_issue.jpg) 

## 安装( 启动 npx 时可直接跳过此步骤)

### 先决条件

-   去1.23.0或更高处
-   吉特账户 带有访问符, [进去吧](https://gitee.com/profile/personal_access_tokens)

### 来源建筑

1.  清除仓库 :
    
    ```bash
    git clone https://gitee.com/oschina/mcp-gitee.git
    cd mcp-gitee
    ```
    
2.  构建工程 :
    
    ```bash
    make build
    ```
    
    移动./bin/mcp-gitee PATH 封装
    

### 使用去安装

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

## 使用量

请检查mcp-gitee版本 :

```bash
mcp-gitee --version
```

## MCP 主机配置

[![](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/logos/Claude.png)](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/claude.md "Claude") [![](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/logos/Cursor.png)](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/cursor.md "Cursor") [![](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/logos/Trae.png)](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/trae.md "Trae") [![](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/logos/Cline.png)](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/cline.md "Cline") [![](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/logos/Windsurf.png)](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/windsurf.md "Windsurf")

配置实例 : [点击可查看更多应用程序配置](https://npmcn.com/package/%40gitee/mcp-gitee/docs/install/)

-   连接到正式的远程 mcp- gitee 服务器( 不需要安装)

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

-   npx 数据

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

-   可执行文件

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

### 命令行选项

-   `--token`: gite 访问符
-   `--api-base`: Gitee API 基址( 默认 ): [https://gitee.com/api/v5 请检查isbn=值 (帮助)](https://gitee.com/api/v5)(中文(简体) )
-   `--version`: 显示版本信息
-   `--transport`: 运输类型(stdio.sse或http,默认:stdio)
-   `--address`: 启动服务器的主机和端口( 默认: localhost: 8000)
-   `--enabled-toolsets`: 以逗号分隔的工具列表以启用(如果指定,将只启用这些工具)
-   `--disabled-toolsets`: 以逗号分隔的禁用工具列表

### 环境变量

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

-   `GITEE_ACCESS_TOKEN`: gite 访问符
-   `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` 优先排序
-   工具名称对大小写有敏感认识

## 许可证

这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40gitee/mcp-gitee/LICENSE) 以备详细文件.

## 可用工具

该服务器提供了各种与 Gitee 互动的工具:

| 工具 | 类别 | 说明 |
| --- | --- | --- |
| **列表( u)** | 仓库 | 列出用户授权寄存器 |
| **获取文件 内容** | 仓库 | 在仓库中获取文件内容 |
| **创建( repo)** | 仓库 | 创建仓库( 用户、 org 或企业) |
| **叉存储器( r)** | 仓库 | 叉子仓库 |
| **创建( r)** | 仓库 | 为仓库创建发行 |
| **列表( l)** | 仓库 | 列表存储器发布 |
| **搜索 开源 仓库** | 仓库 | 在 Gitee 上搜索开源寄存器 |
| **搜索 文件 by content** | 仓库 | 在仓库中按内容搜索文件 |
| **比较( branches tags)** | 仓库 | 比较两个分支、 标记或存储器中的承诺 |
| **列表( repo pulls)** | 拉请求 | 在仓库中列出拉动请求 |
| **合并( p)** | 拉请求 | 合并拉动请求 |
| **创建( p)** | 拉请求 | 创建拉动请求 |
| **更新( p)** | 拉请求 | 更新拉动请求 |
| **获取( p)** | 拉请求 | 获取拉动请求的细节 |
| **获取 diff 文件** | 拉请求 | 获取调取请求 diff 文件 |
| **管理( p)** | 拉请求 | 管理拉动请求审查( 批准或取消) |
| **创建( c)** | 注释 | 对一个问题创建评论或拉动请求 |
| **列表( m)** | 注释 | 为一个问题或拉动请求列出所有评论意见 |
| **创建( i)** | 问题 | 创建问题 |
| **更新 问题** | 问题 | 更新一个问题 |
| **获取 repo issues 详情** | 问题 | 获取仓库问题的细节 |
| **列表( repo issues)** | 问题 | 清单存放问题 |
| **获取用户 info** | 用户 | 获取当前认证的用户信息 |
| **搜索用户** | 用户 | 搜索用户 |
| **列表( u)** | 通知 | 列出用户通知 |

## 捐款

我们欢迎开放源码社区的贡献! 请遵照本准则办理

1.  叉出宝库.
2.  为您的特性或错误修正创建新分支 .
3.  做你的修改 并确保代码有详细记录.
4.  提交一个拉动请求, 并清楚描述您的更改 .

详情请查阅 [捐款](https://npmcn.com/package/%40gitee/mcp-gitee/CONTRIBUTING.md) 文档.

## 常见问题

### @gitee/mcp-gitee 是什么？

Gitee 的模型上下文协议服务器

### 如何安装 @gitee/mcp-gitee？

在项目目录运行 npm install @gitee/mcp-gitee，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-gitee，可以用 npx mcp-gitee 直接运行。

### @gitee/mcp-gitee 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gitee\_\_mcp-gitee 是否存在。

### @gitee/mcp-gitee 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @gitee/mcp-gitee 可以商用吗？

@gitee/mcp-gitee 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gitee/mcp-gitee 的下载量有多少？

根据 npm 官方下载统计，@gitee/mcp-gitee 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,411 次，日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gitee/mcp-gitee 还在维护吗？

最新版本 1\.0\.0 发布于 2026/04/23（6 个月前）；至今共发布 10 个版本，其中过去 12 个月发布了 4 个；首次发布于 2025/04/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

