Gitee MCP Server

让 AI 通过 MCP 为你操作 Gitee 仓库/Issues/Pull Requests

支持的 AI 操作

使用方法

通过 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 账户设置中的 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 镜像

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

# Build locally
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 服务器将在标准输入输出上运行，允许它被 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