Gitee MCP Server

Gitee MCP 服务器是一个用于 Gitee 的模型上下文协议（Model Context Protocol，MCP）服务器实现。它提供了一系列与 Gitee API 交互的工具，使 AI 助手能够管理仓库、问题、拉取请求等。

功能特点

• 与 Gitee 仓库、Issue、Pull Request和通知进行交互
• 可配置的 API 基础 URL，支持不同的 Gitee 实例
• 命令行标志，便于配置
• 支持个人、组织和企业操作

安装

前提条件

• Go 1.23.0 或更高版本
• 拥有访问令牌的 Gitee 账户，前往获取

从源代码构建

1. 克隆仓库：

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee
   

2. 构建项目：

   make build
   

   将 ./bin/mcp-gitee 移动至系统环境变量

使用 go install 安装

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

使用方法

检查 mcp-gitee 版本：

mcp-gitee --version

MCP Hosts 配置

Cursor、Windsurf 配置示例:

{
  "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，默认：stdio）
• -sse-address：启动 SSE 服务器的主机和端口（默认：localhost:8000）

环境变量

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

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

许可证

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

可用工具

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

贡献

我们欢迎开源社区的贡献！如果您想为这个项目做出贡献，请按照以下指南操作：

1. Fork 这个仓库。
2. 为您的功能或 bug 修复创建一个新分支。
3. 进行更改，并确保代码有良好的文档。
4. 提交一个 pull request，并附上清晰的更改描述。

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