@gitee/mcp-gitee

中文文档
1.0.0发布于 2026/04/23MITCommonJS零依赖近 30 天下载 2411

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

中文使用文档
文档目录13 节
  1. 特征
  2. 安装( 启动 npx 时可直接跳过此步骤)
  3. 先决条件
  4. 来源建筑
  5. 使用去安装
  6. 使用量
  7. MCP 主机配置
  8. 命令行选项
  9. 环境变量
  10. 工具管理
  11. 许可证
  12. 可用工具
  13. 捐款

Gitee MCP 服务器

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

Install MCP Server

特征

  • 与Gitee寄存器、问题、调取请求和通知进行互动
  • 支持不同 Gitee 实例的配置 API 基础 URL
  • 易于配置的命令行旗
  • 支持个人、组织和企业业务
  • 动态工具集启用/失效
实际情景:从存储处获取问题,执行和创建拉出请求
  1. 获取仓库问题 get_repo_issues
  2. 根据问题细节执行编码并创建 Pull 请求 implement_issue
  3. 注释关闭问题( C) comment_and_close_issue

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

先决条件

  • 去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 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: gite 访问符
  • --api-base: Gitee API 基址( 默认 ): https://gitee.com/api/v5 请检查isbn=值 (帮助)(中文(简体) )
  • --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 优先排序
  • 工具名称对大小写有敏感认识

许可证

这个项目根据麻省理工学院的许可证获得许可。 见 自由主义 以备详细文件.

可用工具

该服务器提供了各种与 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. 提交一个拉动请求, 并清楚描述您的更改 .

详情请查阅 捐款 文档.

版本与发布记录

@gitee/mcp-gitee 共发布 10 个版本,首次发布于 2025/04/24;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.0latest2026/04/236 个月前
0.1.172026/04/236 个月前
0.1.162026/03/247 个月前
0.1.152026/03/048 个月前
0.1.142025/11/131 年前
0.1.132025/07/241.3 年前

关于 @gitee/mcp-gitee 的常见问题

@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 和提交记录判断。