Gitee MCP Server

Gitee MCP 服务

通过 MCP 让 AI 为你操作 Gitee 仓库、Issue 和 Pull Request

---

支持的 AI 操作

类别	MCP 工具	描述
仓库操作	create_repository	创建 Gitee 仓库
	fork_repository	Fork Gitee 仓库
分支操作	create_branch	在 Gitee 仓库中创建新分支
	list_branches	列出 Gitee 仓库中的分支
	get_branch	获取 Gitee 仓库中特定分支的详细信息
文件操作	get_file_contents	获取 Gitee 仓库中文件或目录的内容
	create_or_update_file	在 Gitee 仓库中创建或更新文件
	push_files	将多个文件推送到 Gitee 仓库
Issue 操作	create_issue	在 Gitee 仓库中创建 Issue
	list_issues	列出 Gitee 仓库中的 Issue
	get_issue	获取 Gitee 仓库中特定 Issue 的详细信息
	update_issue	更新 Gitee 仓库中的 Issue
	add_issue_comment	为 Gitee 仓库中的 Issue 添加评论
Pull Request 操作	create_pull_request	在 Gitee 仓库中创建 Pull Request
	list_pull_requests	列出 Gitee 仓库中的 Pull Request
	get_pull_request	获取 Gitee 仓库中特定 Pull Request 的详细信息
	update_pull_request	更新 Gitee 仓库中的 Pull Request
	merge_pull_request	合并 Gitee 仓库中的 Pull Request
用户操作	get_user	获取 Gitee 用户信息
	get_current_user	获取已认证的 Gitee 用户信息

使用方法

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Gitee MCP Server：

npx -y @smithery/cli install @normal-coder/gitee-mcp-server --client claude

配置

• GITEE_API_BASE_URL：可选，Gitee OpenAPI 端点，默认为 https://gitee.com/api/v5
• GITEE_PERSONAL_ACCESS_TOKEN：必需，Gitee 账户个人访问令牌（PAT），可从 Gitee 账户设置中的个人访问令牌获取
• DEBUG：可选，设为 true 以启用调试日志，默认禁用

通过 NPX 运行 MCP Server

{
  "mcpServers": {
    "Gitee": {
      "command": "npx",
      "args": [
        "-y",
        "gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

通过 Docker 容器运行 MCP Server

1. 获取 Docker 镜像

# Get from DockerHub
docker pull normalcoder/gitee-mcp-server

# Build locally
docker build -t normalcoder/gitee-mcp-server .

2. 配置 MCP Server

{
  "mcpServers": {
    "Gitee": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITEE_PERSONAL_ACCESS_TOKEN",
        "normalcoder/gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

开发指南

安装依赖

npm install

构建

npm run build

构建成功后，/dist 中将包含可运行的 MCP 服务。

运行服务

npm start

MCP 服务将通过 stdio 运行，可作为 MCP 客户端的子进程使用。

构建 Docker 镜像

你也可以使用 Docker 运行服务：

docker build -t normalcoder/gitee-mcp-server .

使用 Docker 运行 MCP 服务：

docker run -e GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> normalcoder/gitee-mcp-server

调试 MCP 服务

你可以使用 @modelcontextprotocol/inspector 进行调试：

在根目录中创建 .env 文件以设置环境变量：

GITEE_API_BASE_URL=https://gitee.com/api/v5
GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN>

运行调试工具以启动服务和 Web 调试界面：

npx @modelcontextprotocol/inspector npm run start --env-file=.env

项目包含一个用于打印调试信息的 debug() 函数，用法如下：

import { debug } from './common/utils.js';

debug('Message to log');
debug('Message with data:', { key: 'value' });

只有在 DEBUG 环境变量设为 true 时才会打印调试日志。

依赖项

• @modelcontextprotocol/sdk：用于实现服务端的 MCP SDK
• universal-user-agent：用于生成用户代理字符串
• zod：用于验证架构
• zod-to-json-schema：用于将 Zod 架构转换为 JSON 架构

许可证

本软件采用 MIT 许可证。您可以自由使用、修改和分发本软件，但须遵守 MIT 许可证的条款与条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

相关链接

• 模型上下文协议
• Gitee