mcp-gitee | 通往MCP之路

Gitee MCP 服务器

Gitee MCP Server 是一个为 Gitee 实现的 Model Context Protocol (MCP) 服务器。它提供了一套工具，用于与 Gitee 的 API 进行交互，使 AI 助手能够管理仓库、问题、拉取请求等。

功能

与 Gitee 仓库、问题、拉取请求和通知进行交互

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

命令行参数，便于配置

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

动态工具集启用/禁用

获取仓库问题

!get_repo_issues 2. 根据问题详情进行编码并创建拉取请求 !implement_issue 3. 评论并关闭问题 !comment_and_close_issue

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

先决条件

Go 1.23.0 或更高版本

Gitee 账户及访问令牌，前往获取

从源码构建

克隆仓库：

构建项目：

将 ./bin/mcp-gitee 移动到 PATH 环境变量中

使用 go install

使用

检查 mcp-gitee 版本：

MCP 主机配置

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

可执行文件

命令行选项

--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	仓库	Fork 仓库
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	通知	列出用户通知

贡献

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

Fork 仓库。

为你的功能或修复创建新分支。

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

提交拉取请求，并清晰描述你的更改。

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