Gitee Integration MCP Server

Version ControlGo

Interact with Gitee repositories, issues, pull requests, and more

Available Tools

get_repository

Get repository information by owner and repo name

ownerrepo

get_repository_issues

Get issues from a repository

ownerrepostatesortdirectionpageper_page

get_repository_issue

Get a specific issue from a repository

ownerreponumber

create_repository_issue

Create a new issue in a repository

ownerrepotitlebodyassigneemilestonelabels

update_repository_issue

Update an existing issue in a repository

ownerreponumbertitlebodyassigneemilestonelabelsstate

create_repository_issue_comment

Create a comment on an issue

ownerreponumberbody

get_repository_pull_requests

Get pull requests from a repository

ownerrepostatesortdirectionpageper_page

get_repository_pull_request

Get a specific pull request from a repository

ownerreponumber

create_repository_pull_request

Create a new pull request in a repository

ownerrepotitlebodyheadbase

Gitee MCP Server provides a comprehensive set of tools for interacting with Gitee's API, enabling AI assistants to manage repositories, issues, pull requests, and other Gitee features. It supports operations for personal accounts, organizations, and enterprises with configurable API endpoints and dynamic toolset management.

Overview

Gitee MCP Server enables AI assistants to interact with Gitee repositories, providing a seamless way to manage code, issues, pull requests, and more through the Gitee API. This integration allows for efficient repository management and collaboration directly from your AI assistant.

Installation

You can install and run the Gitee MCP Server in several ways:

Using npx (Recommended)

The easiest way to use Gitee MCP Server is through npx, which doesn't require any installation:

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "your-personal-access-token"
      }
    }
  }
}

Using Go Install

If you prefer to install it using Go:

go install gitee.com/oschina/mcp-gitee@latest

Then configure your MCP client:

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "your-personal-access-token"
      }
    }
  }
}

Building from Source

For the latest features or custom modifications:

Clone the repository:

git clone https://gitee.com/oschina/mcp-gitee.git
cd mcp-gitee

Build the project:

make build

Add the binary to your PATH or specify the full path in your MCP configuration.

Configuration

Required Environment Variables

GITEE_ACCESS_TOKEN: Your personal access token from Gitee. You can generate one at https://gitee.com/profile/personal_access_tokens

Optional Environment Variables

GITEE_API_BASE: API base URL (default: https://gitee.com/api/v5)
ENABLED_TOOLSETS: Comma-separated list of toolsets to enable
DISABLED_TOOLSETS: Comma-separated list of toolsets to disable

Command Line Options

The server also supports various command-line flags for configuration:

--api-base: Set the Gitee API base URL
--access-token: Set your Gitee access token
--enabled-toolsets: Specify which toolsets to enable
--disabled-toolsets: Specify which toolsets to disable
--version: Display the current version

MCP Client Configuration

The Gitee MCP Server works with various MCP clients including Claude, Cursor, Trae, Cline, and Windsurf. Detailed configuration instructions for each client are available in the documentation.

Usage Examples

Once configured, you can use your AI assistant to:

Get repository issues
Implement code based on issue details
Create pull requests
Comment on and close issues
Manage repositories, branches, and more

Simply ask your AI assistant to perform these tasks, and it will use the Gitee MCP Server to interact with your Gitee repositories.