Gitee MCP 服务器
Gitee MCP Server 是 Gitee 的模型上下文协议 (MCP) 服务器实现。它提供了一组与 Gitee API 交互的工具,允许 AI 助手管理代码库、问题、拉取请求等。
特征
- 与 Gitee 存储库、问题、拉取请求和通知进行交互
- 可配置 API 基本 URL 以支持不同的 Gitee 实例
- 命令行标志,方便配置
- 支持个人、组织和企业运营
- 动态工具集启用/禁用
- 获取存储库问题

- 根据问题详情实施编码并创建 Pull Request

- 评论并关闭问题

安装(启动npx时可直接跳过此步骤)
先决条件
- Go 1.23.0 或更高版本
- 带有访问令牌的 Gitee 帐户,前往获取
从源代码构建
- 克隆存储库:
git clone https://gitee.com/oschina/mcp-gitee.git
cd mcp-gitee
- 构建项目:移动 ./bin/mcp-gitee PATH 环境变量
使用 go install
go install gitee.com/oschina/mcp-gitee@latest
用法
检查 mcp-gitee 版本:
MCP 主机配置
配置示例:点击查看更多应用配置
{
"mcpServers": {
"gitee": {
"command": "npx",
"args": [
"-y",
"@gitee/mcp-gitee@latest"
],
"env": {
"GITEE_API_BASE": "https://gitee.com/api/v5",
"GITEE_ACCESS_TOKEN": "<your personal access token>"
}
}
}
}
{
"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)--enabled-toolsets
:要启用的工具的逗号分隔列表(如果指定,则仅启用这些工具)--disabled-toolsets
:要禁用的工具的逗号分隔列表
环境变量
您还可以使用环境变量配置服务器:
GITEE_ACCESS_TOKEN
:Gitee 访问令牌GITEE_API_BASE
:Gitee API 基本 URLENABLED_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 许可证。更多详情请参阅许可证文件。
可用工具
服务器提供了各种与 Gitee 交互的工具:
工具 | 类别 | 描述 |
---|
列出用户存储库 | 存储库 | 列出用户授权的存储库 |
获取文件内容 | 存储库 | 获取存储库中文件的内容 |
创建用户仓库 | 存储库 | 创建用户存储库 |
创建组织仓库 | 存储库 | 创建组织存储库 |
创建进入仓库 | 存储库 | 创建企业存储库 |
fork_repository | 存储库 | 派生一个存储库 |
创建发布 | 存储库 | 为存储库创建发布 |
列表发布 | 存储库 | 列出存储库版本 |
搜索开源存储库 | 存储库 | 在 Gitee 上搜索开源存储库 |
列出仓库 | 拉取请求 | 列出存储库中的拉取请求 |
合并拉取 | 拉取请求 | 合并拉取请求 |
创建拉取 | 拉取请求 | 创建拉取请求 |
更新拉取 | 拉取请求 | 更新拉取请求 |
获取拉取详细信息 | 拉取请求 | 获取拉取请求的详细信息 |
评论拉取 | 拉取请求 | 对拉取请求进行评论 |
列出拉取评论 | 拉取请求 | 列出拉取请求的所有评论 |
创建问题 | 问题 | 创建问题 |
更新问题 | 问题 | 更新问题 |
获取仓库问题详情 | 问题 | 获取存储库问题的详细信息 |
列出仓库问题 | 问题 | 列出存储库问题 |
评论问题 | 问题 | 对问题进行评论 |
列出问题评论 | 问题 | 列出对问题的评论 |
获取用户信息 | 用户 | 获取当前已认证用户信息 |
搜索用户 | 用户 | 搜索用户 |
列出用户通知 | 通知 | 列出用户通知 |
贡献
我们欢迎开源社区的贡献!如果您想为这个项目做出贡献,请遵循以下准则:
- 分叉存储库。
- 为您的功能或错误修复创建一个新的分支。
- 进行更改并确保代码有详细记录。
- 提交拉取请求并清晰描述您的更改。
欲了解更多信息,请参阅CONTRIBUTING文件。