Skip to main content
Glama

Gitee MCP Server

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

Node Version NPM Version Docker Pulls Docker Image Version LICENSE smithery badge


Supported AI Operations

Category

MCP Tool

Description

Repository Operations

create_repository

Create a Gitee repository

fork_repository

Fork a Gitee repository

Branch Operations

create_branch

Create a new branch in a Gitee repository

list_branches

List branches in a Gitee repository

get_branch

Get details of a specific branch in a Gitee repository

File Operations

get_file_contents

Get contents of a file or directory in a Gitee repository

create_or_update_file

Create or update a file in a Gitee repository

push_files

Push multiple files to a Gitee repository

Issue Operations

create_issue

Create an Issue in a Gitee repository

list_issues

List Issues in a Gitee repository

get_issue

Get details of a specific Issue in a Gitee repository

update_issue

Update an Issue in a Gitee repository

add_issue_comment

Add a comment to an Issue in a Gitee repository

Pull Request Operations

create_pull_request

Create a Pull Request in a Gitee repository

list_pull_requests

List Pull Requests in a Gitee repository

get_pull_request

Get details of a specific Pull Request in a Gitee repository

update_pull_request

Update a Pull Request in a Gitee repository

merge_pull_request

Merge a Pull Request in a Gitee repository

User Operations

get_user

Get Gitee user information

get_current_user

Get authenticated Gitee user information

Usage

Installing via Smithery

To install Gitee MCP Server for Claude Desktop automatically via Smithery:

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

Configuration

  • GITEE_API_BASE_URL: Optional, Gitee OpenAPI Endpoint, default is https://gitee.com/api/v5

  • GITEE_PERSONAL_ACCESS_TOKEN: Required, Gitee account personal access token (PAT), can be obtained from Gitee account settings Personal Access Tokens

  • DEBUG: Optional, set to true to enable debug logging, default is disabled

Run MCP Server via NPX

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

Run MCP Server via Docker Container

  1. Get Docker Image

# Get from DockerHub docker pull normalcoder/gitee-mcp-server # Build locally docker build -t normalcoder/gitee-mcp-server .
  1. Configure 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>" } } } }

Development Guide

Install Dependencies

npm install

Build

npm run build

After successful build, /dist will contain the runnable MCP server.

Run Server

npm start

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

Build Docker Image

You can also run the server using Docker:

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

Run MCP Server with Docker:

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

Debug MCP Server

You can use @modelcontextprotocol/inspector for debugging:

Create a .env file in the root directory for environment variables:

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

Run the debug tool to start the service and web debug interface:

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

The project includes a debug() function for printing debug information, usage:

import { debug } from './common/utils.js'; debug('Message to log'); debug('Message with data:', { key: 'value' });

Debug logs are only printed when the DEBUG environment variable is set to true.

Dependencies

  • @modelcontextprotocol/sdk: MCP SDK for server implementation

  • universal-user-agent: For generating user agent strings

  • zod: For schema validation

  • zod-to-json-schema: For converting Zod schemas to JSON schemas

License

Licensed under MIT License. You are free to use, modify and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the LICENSE file in the project repository.

Related Links

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP Tool Server for Gitee, supporting the management of repository files/branches, Issues, and Pull Requests.

  1. Supported AI Operations
    1. Usage
      1. Installing via Smithery
      2. Configuration
      3. Run MCP Server via NPX
      4. Run MCP Server via Docker Container
    2. Development Guide
      1. Install Dependencies
      2. Build
      3. Run Server
      4. Build Docker Image
      5. Debug MCP Server
    3. Dependencies
      1. License
        1. Related Links

          Related MCP Servers

          • A
            security
            F
            license
            A
            quality
            MCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.
            Last updated -
            18
            0
            4
            • Linux
            • Apple
          • A
            security
            A
            license
            A
            quality
            A specialized MCP server for in-depth analysis of git repositories, offering tools for branch overview, time period analysis, file changes, and merge recommendations.
            Last updated -
            4
            2
            Apache 2.0
          • A
            security
            F
            license
            A
            quality
            MCP server for managing Git operations on local repositories, allowing users to list repositories, get and create tags, list commits, push tags, and refresh repositories through a standardized interface.
            Last updated -
            6
            3
          • A
            security
            A
            license
            A
            quality
            An MCP server for gitingest. It allows MCP clients like Claude Desktop, Cursor, Cline etc to quickly extract information about Github repositories including repository summaries, project directory structure, file contents, etc
            Last updated -
            3
            122
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/normal-coder/gitee-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server