Gitee Enterprise MCP Server

Gitee Enterprise MCP 服务

Gitee Enterprise MCP 服务是面向 Gitee Enterprise 的模型上下文协议（MCP）服务实现。它提供了一组用于与 Gitee Enterprise API 交互的工具，让 AI 助手能够管理企业仓库、议题、拉取请求等。

功能

• 与 Gitee Enterprise 仓库、议题和拉取请求交互
• 支持企业级操作与管理
• 可配置 API 基础 URL，以支持不同的 Gitee Enterprise 实例
• 支持 SSE 和 Stdio 传输
• 动态启用或禁用工具集

场景示例

1. 获取指定企业议题
2. 改进议题内容
3. 拆分子任务
4. 创建 PR／审查 PR

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

前置条件

• Go 1.23.0 或更高版本
• MCP 令牌，前往获取

从源代码构建

1. 克隆仓库：

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

2. 构建项目：

   make build
   

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

使用 go install

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

用法

检查 mcp-gitee-ent 版本：

mcp-gitee-ent --version

MCP 宿主配置

配置示例：

• npx

{
  "mcpServers": {
    "gitee-ent": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee-ent@latest"
      ],
      "env": {
         "GITEE_ENT_API_BASE": "https://api.gitee.com/enterprises",
         "GITEE_ENT_MCP_ACCESS_TOKEN": "<your mcp ent access token>"
      }
    }
  }
}

• 可执行文件

{
  "mcpServers": {
    "gitee-ent": {
      "command": "mcp-gitee-ent",
      "env": {
        "GITEE_ENT_API_BASE": "https://api.gitee.com/enterprises",
        "GITEE_ENT_MCP_ACCESS_TOKEN": "<your mcp ent access token>",
      }
    }
  }
}

命令行选项

• --token：访问令牌
• --api-base：Gitee Ent API 基础 URL（默认值：https://api.gitee.com/enterprises）
• --version：显示版本信息
• --transport：传输类型（stdio 或 sse，默认值：stdio）
• --sse-address：启动 SSE 服务的主机和端口（默认值：localhost:8000）
• --enabled-toolsets：要启用的工具列表，以逗号分隔（如果指定，则仅启用这些工具）
• --disabled-toolsets：要禁用的工具列表，以逗号分隔

环境变量

也可以通过环境变量配置服务：

• GITEE_ENT_MCP_ACCESS_TOKEN：Gitee MCP ent 访问令牌
• GITEE_ENT_API_BASE：Gitee ENT API 基础 URL
• ENABLED_TOOLSETS：要启用的工具列表，以逗号分隔
• DISABLED_TOOLSETS：要禁用的工具列表，以逗号分隔

工具集管理

工具集管理支持两种模式：

1. 启用指定工具（白名单模式）：

   • 使用 --enabled-toolsets 参数或 ENABLED_TOOLSETS 环境变量
   • 指定后，仅启用列出的工具，其他工具将被禁用
   • 示例：--enabled-toolsets="update_enterprise_issue,list_enterprise_repositories"

2. 禁用指定工具（黑名单模式）：

   • 使用 --disabled-toolsets 参数或 DISABLED_TOOLSETS 环境变量
   • 指定后，禁用列出的工具，其他工具将被启用
   • 示例：--disabled-toolsets="update_enterprise_issue,list_enterprise_repositories"

注意：

• 如果同时指定 enabled-toolsets 和 disabled-toolsets，则以 enabled-toolsets 为准
• 工具名称区分大小写

可用工具

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

工具	类别	描述
list_enterprises	企业	列出用户的企业
list_enterprise_repositories	仓库	列出企业中的仓库
create_enterprise_repository	仓库	在企业中创建仓库
create_enterprise_repo_release	仓库	为仓库创建发布
list_enterprise_repo_releases	仓库	列出仓库的发布
get_enterprise_repository_file_content	仓库	获取仓库中特定文件的内容
get_enterprise_repo_tree	仓库	获取仓库的树形结构
list_enterprise_pulls	拉取请求	列出企业的拉取请求
create_enterprise_repo_pull	拉取请求	为仓库创建拉取请求
merge_enterprise_pull	拉取请求	合并拉取请求
get_enterprise_pull_detail	拉取请求	获取拉取请求详情
update_enterprise_pull	拉取请求	更新拉取请求
get_enterprise_pull_diff	拉取请求	获取拉取请求差异
comment_enterprise_pull	拉取请求	评论拉取请求
list_enterprise_pull_comments	拉取请求	列出拉取请求评论
create_enterprise_issue	问题	创建问题
update_enterprise_issue	问题	更新问题
get_enterprise_issue_detail	问题	获取问题详情
list_enterprise_issues	问题	列出问题
comment_enterprise_issue	问题	评论问题
list_enterprise_issue_comments	问题	列出问题评论
get_user_info	用户	获取用户信息
list_enterprise_members	成员	列出企业成员
list_enterprise_groups	群组	列出企业中的群组
list_enterprise_labels	标签	列出企业的标签
list_programs	项目	列出企业的项目
list_scrum_sprints	项目	列出 Scrum 迭代
create_scrum_sprint	项目	创建 Scrum 迭代
list_scrum_versions	项目	列出 Scrum 版本
list_issue_types	问题类型	列出问题类型
list_issue_type_states	问题状态	列出问题状态

贡献

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

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

如需了解更多信息，请参阅 CONTRIBUTING 文件。