Gitee MCP 服务器

通过 MCP 让 AI 操作 Gitee 仓库/Issue/Pull Request

<img width="380" height="200" src="https://glama.ai/mcp/servers/cck9xigm1d/badge" />

---

支持的 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 服务器：

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 帐户设置 Personal Access Tokens 获取
• DEBUG: 可选，设置为 true 以启用调试日志记录，默认禁用

通过 NPX 运行 MCP 服务器

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

通过 Docker 容器运行 MCP 服务器

1. 获取 Docker 镜像

# 从 DockerHub 获取
docker pull normalcoder/gitee-mcp-server

# 本地构建
docker build -t normalcoder/gitee-mcp-server .

2. 配置 MCP 服务器

{
  "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 文件。

相关链接

• Model Context Protocol
• Gitee