跳到主要内容

介绍

Gitee 企业版 MCP Server(mcp-gitee-ent)是 Gitee 企业版的模型上下文协议(MCP)服务器实现。它为 AI 助手等智能应用提供与 Gitee 企业版 API 的集成能力,支持企业级仓库、Issue、Pull Request 等多种操作,助力企业智能化协作。

核心功能

  • 与 Gitee 企业版仓库、Issue、Pull Request 等交互
  • 支持企业级操作和管理
  • 可配置 API 基础 URL,适配不同 Gitee 企业版实例
  • 支持 SSE 和 Stdio 两种传输方式
  • 支持动态启用/禁用工具集

安装方式

1. npx 启动(推荐,见下方配置)

2. Go 安装

确保已安装 Go 1.23.0 及以上版本。

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

3. 源码构建

git clone https://gitee.com/oschina/mcp-gitee-ent.git
cd mcp-gitee-ent
make build
# 将 ./bin/mcp-gitee-ent 移动到 PATH 路径下

使用方法

检查版本:

mcp-gitee-ent --version

配置说明

MCP Server 支持多种主机和客户端(如 Claude、Cursor、Trae、Cline、Windsurf)对接。

配置示例

  • 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 企业版 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 企业版访问令牌
  • GITEE_ENT_API_BASE:Gitee 企业版 API 基础 URL
  • ENABLED_TOOLSETS:启用的工具列表
  • DISABLED_TOOLSETS:禁用的工具列表

工具集管理

  • 启用指定工具(白名单):--enabled-toolsetsENABLED_TOOLSETS,仅启用列出的工具
  • 禁用指定工具(黑名单):--disabled-toolsetsDISABLED_TOOLSETS,禁用列出的工具
  • 若同时指定,enabled-toolsets 优先
  • 工具名称区分大小写

可用工具

工具类别描述
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_pullsPull Request列出企业拉取请求
create_enterprise_repo_pullPull Request创建仓库拉取请求
merge_enterprise_pullPull Request合并拉取请求
get_enterprise_pull_detailPull Request获取拉取请求详情
update_enterprise_pullPull Request更新拉取请求
get_enterprise_pull_diffPull Request获取拉取请求差异
comment_enterprise_pullPull Request评论拉取请求
list_enterprise_pull_commentsPull Request列出拉取请求评论
create_enterprise_issueIssue创建 Issue
update_enterprise_issueIssue更新 Issue
get_enterprise_issue_detailIssue获取 Issue 详情
list_enterprise_issuesIssue列出 Issues
comment_enterprise_issueIssue评论 Issue
list_enterprise_issue_commentsIssue列出 Issue 评论
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工作项状态列出工作项状态

如需进一步了解或遇到问题,欢迎查阅 官方文档 或联系技术支持。