码云Gitee MCP
Gitee MCP 服务器是为 Gitee 实现的模型上下文协议（MCP）服务器，提供了一组工具来与 Gitee 的 API 进行交互。它允许 AI 助手管理仓库、问题、拉取请求等。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"gitee": {
"command": "mcp-gitee",
"env": {
"GITEE_ACCESS_TOKEN": "\u003cyour personal access token\u003e",
"GITEE_API_BASE": "https://gitee.com/api/v5"
}
}
}
}该服务需要配置环境变量：GITEE_ACCESS_TOKEN、GITEE_API_BASE
服务介绍
Gitee MCP 服务器
Gitee MCP 服务器是为 Gitee 实现的 Model Context Protocol (MCP) 服务器。它提供了一组工具，用于与 Gitee 的 API 进行交互，使 AI 助手能够管理仓库、问题、拉取请求等。
特性
- 与 Gitee 仓库、问题、拉取请求和通知进行交互
- 可配置的 API 基础 URL 以支持不同的 Gitee 实例
- 命令行标志便于配置
- 支持个人、组织和企业操作
- 动态启用/禁用工具集
- 获取仓库中的问题
- 根据问题详情实现编码并创建拉取请求
- 评论并关闭问题
安装（在使用 npx 启动时可以跳过此步骤）
前提条件
- Go 1.23.0 或更高版本
- 拥有访问令牌的 Gitee 账户，前往获取
从源代码构建
-
克隆仓库：
bash
git clone https://gitee.com/oschina/mcp-gitee.git
cd mcp-gitee -
构建项目：
bash
make build将 ./bin/mcp-gitee 移动到 PATH 环境变量中
使用 go install
bash
go install gitee.com/oschina/mcp-gitee@latest
使用
检查 mcp-gitee 版本：
bash
mcp-gitee --version
MCP 主机配置
配置示例：点击查看更多应用配置
-
连接到官方远程 mcp-gitee 服务器（无需安装）
json
{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
} -
npx
json
{
"mcpServers": {
"gitee": {
"command": "npx",
"args": [
"-y",
"@gitee/mcp-gitee@latest"
],
"env": {
"GITEE_API_BASE": "https://gitee.com/api/v5",
"GITEE_ACCESS_TOKEN": ""
}
}
}
} -
可执行文件
json
{
"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 或 http，默认: stdio）--address: 启动服务器的主机和端口（默认: 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 许可证。有关更多详细信息，请参阅 LICENSE 文件。
可用工具
服务器提供了多种与 Gitee 交互的工具：
| 工具 | 类别 | 描述 |
|---|---|---|
| list_user_repos | 仓库 | 列出用户授权的仓库 |
| get_file_content | 仓库 | 获取仓库中文件的内容 |
| create_user_repo | 仓库 | 创建用户仓库 |
| create_org_repo | 仓库 | 创建组织仓库 |
| create_enter_repo | 仓库 | 创建企业仓库 |
| fork_repository | 仓库 | Fork 一个仓库 |
| create_release | 仓库 | 为仓库创建发布版本 |
| list_releases | 仓库 | 列出仓库的发布版本 |
| search_open_source_repositories | 仓库 | 在 Gitee 上搜索开源仓库 |
| 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 | 用户 | 获取当前认证用户的信息 |
| search_users | 用户 | 搜索用户 |
| list_user_notifications | 通知 | 列出用户的通知 |
贡献
我们欢迎来自开源社区的贡献！如果您想为该项目做出贡献，请遵循以下指南：
- Fork 仓库。
- 为您的功能或错误修复创建一个新的分支。
- 进行更改，并确保代码有良好的文档说明。
- 提交带有清晰描述的拉取请求。
有关更多信息，请参阅 CONTRIBUTING 文件。
