Gitee MCP-Server

Gitee MCP-Server ist eine Model Context Protocol (MCP)-Serverimplementierung für Gitee. Er bietet eine Reihe von Tools für die Interaktion mit der Gitee-API, die es KI-Assistenten ermöglichen, Repositories, Issues, Pull Requests und mehr zu verwalten.

Funktionen

• Interaktion mit Gitee-Repositories, Issues, Pull Requests und Benachrichtigungen

• Konfigurierbare API-Basis-URL zur Unterstützung verschiedener Gitee-Instanzen

• Befehlszeilen-Flags für einfache Konfiguration

• Unterstützt persönliche, Organisations- und Unternehmensvorgänge

• Dynamische Aktivierung/Deaktivierung von Toolsets

1. Repository-Issues abrufen

2. Implementierung programmieren & Pull Request basierend auf Issue-Details erstellen

3. Kommentieren & Issue schließen

Related MCP server: PyGithub MCP Server

Installation (Dieser Schritt kann beim Starten mit npx übersprungen werden)

Voraussetzungen

• Go 1.23.0 oder höher

• Gitee-Konto mit einem Zugriffstoken, Hier abrufen

Aus dem Quellcode erstellen

1. Repository klonen:

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

2. Projekt erstellen:

   make build

   Verschieben Sie ./bin/mcp-gitee in den PATH

Verwendung von go install

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

Verwendung

Überprüfen der mcp-gitee-Version:

mcp-gitee --version

MCP-Host-Konfiguration

Konfigurationsbeispiel: Klicken Sie hier, um weitere Anwendungskonfigurationen anzuzeigen

• Verbindung zum offiziellen Remote-mcp-gitee-Server (keine Installation erforderlich)

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

• npx

{
  "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>"
      }
    }
  }
}

• ausführbare Datei

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

Befehlszeilenoptionen

• --token: Gitee-Zugriffstoken

• --api-base: Gitee-API-Basis-URL (Standard: https://gitee.com/api/v5)

• --version: Versionsinformationen anzeigen

• --transport: Transporttyp (stdio, sse oder http, Standard: stdio)

• --address: Host und Port, auf dem der Server gestartet werden soll (Standard: localhost:8000)

• --enabled-toolsets: Durch Kommas getrennte Liste der zu aktivierenden Tools (falls angegeben, werden nur diese Tools aktiviert)

• --disabled-toolsets: Durch Kommas getrennte Liste der zu deaktivierenden Tools

Umgebungsvariablen

Sie können den Server auch über Umgebungsvariablen konfigurieren:

• GITEE_ACCESS_TOKEN: Gitee-Zugriffstoken

• GITEE_API_BASE: Gitee-API-Basis-URL

• ENABLED_TOOLSETS: Durch Kommas getrennte Liste der zu aktivierenden Tools

• DISABLED_TOOLSETS: Durch Kommas getrennte Liste der zu deaktivierenden Tools

Toolset-Verwaltung

Die Toolset-Verwaltung unterstützt zwei Modi:

1. Aktivieren bestimmter Tools (Whitelist-Modus):

   • Verwenden Sie den Parameter --enabled-toolsets oder die Umgebungsvariable ENABLED_TOOLSETS

   • Nach der Angabe werden nur die aufgeführten Tools aktiviert, andere werden deaktiviert

   • Beispiel: --enabled-toolsets="list_user_repos,get_file_content"

2. Deaktivieren bestimmter Tools (Blacklist-Modus):

   • Verwenden Sie den Parameter --disabled-toolsets oder die Umgebungsvariable DISABLED_TOOLSETS

   • Nach der Angabe werden die aufgeführten Tools deaktiviert, andere werden aktiviert

   • Beispiel: --disabled-toolsets="list_user_repos,get_file_content"

Hinweis:

• Wenn sowohl enabled-toolsets als auch disabled-toolsets angegeben sind, hat enabled-toolsets Vorrang

• Toolnamen unterscheiden zwischen Groß- und Kleinschreibung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Details finden Sie in der Datei LICENSE.

Verfügbare Tools

Der Server bietet verschiedene Tools für die Interaktion mit Gitee:

Beitrag

Wir freuen uns über Beiträge aus der Open-Source-Community! Wenn Sie zu diesem Projekt beitragen möchten, befolgen Sie bitte diese Richtlinien:

1. Forken Sie das Repository.

2. Erstellen Sie einen neuen Branch für Ihr Feature oder Ihren Bugfix.

3. Nehmen Sie Ihre Änderungen vor und stellen Sie sicher, dass der Code gut dokumentiert ist.

4. Senden Sie einen Pull Request mit einer klaren Beschreibung Ihrer Änderungen.

Weitere Informationen finden Sie in der Datei CONTRIBUTING.