Gitee MCP 服务器

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

特性

• 与 Gitee 仓库、议题、拉取请求和通知交互
• 可配置的 API 基础 URL，以支持不同的 Gitee 实例
• 命令行标志，便于配置
• 支持个人、组织和企业操作

<details> <summary><b>实际场景：从仓库获取议题，实现并创建拉取请求</b></summary>

1. 获取仓库议题
2. 根据议题详情实现编码并创建拉取请求
3. 评论并关闭议题 </details>

安装

前提条件

• 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 主机配置

<div align="center"> <a href="docs/install/claude.md" title="Claude"><img src="docs/install/logos/Claude.png" width=80 height=80></a> <a href="docs/install/cursor.md" title="Cursor"><img src="docs/install/logos/Cursor.png" width=80 height=80></a> <a href="docs/install/cline.md" title="Cline"><img src="docs/install/logos/Cline.png" width=80 height=80></a> <a href="docs/install/windsurf.md" title="Windsurf"><img src="docs/install/logos/Windsurf.png" width=80 height=80></a> </div>

Cursor、Windsurf 配置示例：

{
  "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)

环境变量

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

• GITEE_ACCESS_TOKEN: Gitee 访问令牌
• GITEE_API_BASE: Gitee API 基础 URL

许可证

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

可用工具

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

工具	类别	描述
list_user_repos	仓库	列出用户授权的仓库
get_file_content	仓库	获取仓库中文件的内容
create_user_repo	仓库	创建用户仓库
create_org_repo	仓库	创建组织仓库
create_enter_repo	仓库	创建企业仓库
create_release	仓库	为仓库创建发布版本
list_releases	仓库	列出仓库发布版本
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	用户	获取当前已验证用户的个人信息
list_user_notifications	通知	列出用户通知

贡献

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

1. Fork 仓库。
2. 为您的功能或错误修复创建一个新分支。
3. 进行更改并确保代码有良好的文档记录。
4. 提交一个拉取请求，并清楚地描述您的更改。

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