Gitee MCP Server

@normal-coder

About Gitee MCP Server

Let AI operate Gitee Repositories / Issues / Pull Requests for you through MCP

#gitee #mcp-server #repository-management

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gitee-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@normal-coder/gitee-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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](https://gitee.com/profile/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.

Comments

Basic information

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K