Integrations

  • Enables AI to interact with Gitee repositories, including creating/managing repositories, branches, files, issues, and pull requests. Supports operations like pushing code, creating issues, managing PRs, and performing user-related actions on Gitee's platform.

Gitee MCP Server

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


Supported AI Operations

CategoryMCP ToolDescription
Repository Operationscreate_repositoryCreate a Gitee repository
fork_repositoryFork a Gitee repository
Branch Operationscreate_branchCreate a new branch in a Gitee repository
list_branchesList branches in a Gitee repository
get_branchGet details of a specific branch in a Gitee repository
File Operationsget_file_contentsGet contents of a file or directory in a Gitee repository
create_or_update_fileCreate or update a file in a Gitee repository
push_filesPush multiple files to a Gitee repository
Issue Operationscreate_issueCreate an Issue in a Gitee repository
list_issuesList Issues in a Gitee repository
get_issueGet details of a specific Issue in a Gitee repository
update_issueUpdate an Issue in a Gitee repository
add_issue_commentAdd a comment to an Issue in a Gitee repository
Pull Request Operationscreate_pull_requestCreate a Pull Request in a Gitee repository
list_pull_requestsList Pull Requests in a Gitee repository
get_pull_requestGet details of a specific Pull Request in a Gitee repository
update_pull_requestUpdate a Pull Request in a Gitee repository
merge_pull_requestMerge a Pull Request in a Gitee repository
User Operationsget_userGet Gitee user information
get_current_userGet 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.

You must be authenticated.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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
            A
            license
            A
            quality
            MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
            Last updated -
            17
            22,912
            43,638
            JavaScript
            MIT License
          • 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
            4
            1
            TypeScript
          • -
            security
            A
            license
            -
            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
            1
            JavaScript
            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
            Python

          View all related MCP servers

          ID: cck9xigm1d