oschina_mcp_gitee

oschina_mcp_gitee

by oschina
A Model Context Protocol (MCP) server implementation for Gitee, enabling AI assistants to manage repositories, issues, and pull requests.

Gitee MCP Server: AI-Powered Repository Management

The Gitee MCP Server is a specialized implementation of the Model Context Protocol (MCP) designed to interact with Gitee's API. It enables AI assistants to manage repositories, issues, pull requests, and more, streamlining development workflows.

Overview

The Gitee MCP Server is a toolset that bridges AI assistants and Gitee's platform, allowing for seamless automation of repository management tasks. It supports personal, organizational, and enterprise-level operations, making it versatile for various use cases.

Key Features

  • Repository Management: Create, list, and manage repositories for users, organizations, and enterprises.
  • Issue and Pull Request Handling: Automate issue tracking, pull request creation, and merging.
  • Notifications: List and manage user notifications.
  • Customizable API Integration: Configure the API base URL to support different Gitee instances.
  • Command-Line Tools: Easy configuration with command-line flags.

Practical Use Case: Issue to Pull Request Workflow

  1. Retrieve Repository Issues:
    Get Repository Issues
  2. Implement Code and Create Pull Request:
    Implement Issue
  3. Comment and Close Issue:
    Comment and Close Issue

Installation

Prerequisites

Building from Source

  1. Clone the repository:
    shell git clone https://gitee.com/oschina/mcp-gitee.git cd mcp-gitee
  2. Build the project:
    shell make build
  3. Add the binary to your PATH.

Using go install

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

Usage

Check the installed version:

mcp-gitee --version

MCP Hosts Configuration

Example configuration for Cursor and Windsurf:

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

Command-Line Options

  • -token: Gitee access token.
  • -api-base: Gitee API base URL (default: https://gitee.com/api/v5).
  • -version: Display version information.
  • -transport: Transport type (stdio or sse, default: stdio).
  • -sse-address: Host and port for SSE server (default: localhost:8000).

Environment Variables

  • GITEE_ACCESS_TOKEN: Gitee access token.
  • GITEE_API_BASE: Gitee API base URL.

Available Tools

Tool Category Description
list_user_repos Repository List user-authorized repositories.
get_file_content Repository Retrieve file content from a repository.
create_user_repo Repository Create a user repository.
create_org_repo Repository Create an organization repository.
create_enter_repo Repository Create an enterprise repository.
create_release Repository Create a release for a repository.
list_releases Repository List repository releases.
list_repo_pulls Pull Request List pull requests in a repository.
merge_pull Pull Request Merge a pull request.
create_pull Pull Request Create a pull request.
update_pull Pull Request Update a pull request.
get_pull_detail Pull Request Get details of a pull request.
comment_pull Pull Request Comment on a pull request.
list_pull_comments Pull Request List all comments for a pull request.
create_issue Issue Create an issue.
update_issue Issue Update an issue.
get_repo_issue_detail Issue Get details of a repository issue.
list_repo_issues Issue List repository issues.
comment_issue Issue Comment on an issue.
list_issue_comments Issue List comments on an issue.
get_user_info User Get current authenticated user information.
list_user_notifications Notification List user notifications.

Contribution

We welcome contributions! To contribute:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and ensure the code is well-documented.
  4. Submit a pull request with a clear description of your changes.

For more details, refer to the CONTRIBUTING file.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Resources

Features & Capabilities

Categories
mcp_server model_context_protocol go gitee api_integration docker

Implementation Details

View on GitHub

Stats

0 Views
14 GitHub Stars

Repository Info

oschina Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI