Gitee MCP Server

What is Gitee MCP Server?

An MCP server that allows AI assistants to operate Gitee repositories, issues, and pull requests. It provides a set of tools for repository, branch, file, issue, pull request, and user operations. Designed for developers who want to manage Gitee projects through AI-powered workflows.

How to use Gitee MCP Server?

Install via Smithery (npx -y @smithery/cli install @normal-coder/gitee-mcp-server), npx (gitee-mcp-server), or Docker (normalcoder/gitee-mcp-server). Configure with a Gitee personal access token (GITEE_PERSONAL_ACCESS_TOKEN) and optionally a custom API base URL (GITEE_API_BASE_URL). Set environment variables in your MCP client configuration.

Key features of Gitee MCP Server

• Repository creation, forking, and branch management
• File operations: get, create/update, push multiple files
• Issue lifecycle: create, list, get, update, comment
• Pull request operations: create, list, get, update, merge
• User information retrieval for authenticated and other users
• Debug mode via DEBUG=true environment variable

Use cases of Gitee MCP Server

• Automate repository creation and initialization from AI chat
• Manage project issues and pull requests without leaving the editor
• Push multiple files to a Gitee repository programmatically
• Retrieve user or repository information during development
• Enable AI-driven code review and merge workflows

FAQ from Gitee MCP Server

What version of Node.js is required?

Node.js version 22.12.0 or higher is required (see badge in README).

How do I authenticate?

Provide a Gitee personal access token via the GITEE_PERSONAL_ACCESS_TOKEN environment variable. Tokens can be generated at Gitee Personal Access Tokens.

How can I run the server with Docker?

Pull the image (docker pull normalcoder/gitee-mcp-server) and run with the token as an environment variable: docker run -e GITEE_PERSONAL_ACCESS_TOKEN=<token> normalcoder/gitee-mcp-server.

How do I enable debug logging?

Set the DEBUG environment variable to "true". Debug output uses a custom debug() function that only prints when enabled.

What transport does the server use?

The MCP server runs on stdio, allowing it to be used as a subprocess by MCP clients.