Gitee

Gitee MCP Server

Gitee MCP Server ist eine Implementierung des Model Context Protocol (MCP) für Gitee. Es stellt eine Reihe von Werkzeugen für die Interaktion mit der Gitee-API bereit, 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 sowohl persönliche, Organisations- als auch Enterprise-Operationen
• Dynamisches Aktivieren/Deaktivieren von Werkzeugsätzen

Praktisches Szenario: Issue aus dem Repository abrufen, implementieren und einen Pull Request erstellen

1. Repository-Issues abrufen
2. Implementierung codieren & Pull Request basierend auf Issue-Details erstellen
3. Kommentieren & Issue schließen

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

Voraussetzungen

• Go 1.23.0 oder höher
• Gitee-Konto mit einem Zugriffstoken, Zum Abrufen

Bauen aus dem Quellcode

1. Repository klonen:

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

2. Projekt bauen:

   make build
   

   ./bin/mcp-gitee in die PATH-Umgebungsvariable verschieben

Verwendung von go install

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

Verwendung

mcp-gitee-Version prüfen:

mcp-gitee --version

MCP-Host-Konfigurationen

Konfigurationsbeispiele: Klicken, um weitere Anwendungskonfigurationen anzuzeigen

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

Remote MCP Server

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

Codex verwendet ~/.codex/config.toml:

[mcp_servers.gitee]
url = "https://api.gitee.com/mcp"
bearer_token_env_var = "GITEE_ACCESS_TOKEN"

opencode verwendet ~/.config/opencode/opencode.json:

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

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 wird (Standard: localhost:8000)
• --enabled-toolsets: Kommagetrennte Liste der zu aktivierenden Werkzeuge (falls angegeben, werden nur diese Werkzeuge aktiviert)
• --disabled-toolsets: Kommagetrennte Liste der zu deaktivierenden Werkzeuge

Umgebungsvariablen

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

• GITEE_ACCESS_TOKEN: Gitee-Zugriffstoken
• GITEE_API_BASE: Gitee-API-Basis-URL
• ENABLED_TOOLSETS: Kommagetrennte Liste der zu aktivierenden Werkzeuge
• DISABLED_TOOLSETS: Kommagetrennte Liste der zu deaktivierenden Werkzeuge

Werkzeugsatz-Verwaltung

Die Werkzeugsatz-Verwaltung unterstützt zwei Modi:

1. Angegebene Werkzeuge aktivieren (Whitelist-Modus):

   • Verwenden Sie den Parameter --enabled-toolsets oder die Umgebungsvariable ENABLED_TOOLSETS
   • Nach der Angabe werden nur die aufgelisteten Werkzeuge aktiviert, andere werden deaktiviert
   • Beispiel: --enabled-toolsets="list_user_repos,get_file_content"

2. Angegebene Werkzeuge deaktivieren (Blacklist-Modus):

   • Verwenden Sie den Parameter --disabled-toolsets oder die Umgebungsvariable DISABLED_TOOLSETS
   • Nach der Angabe werden die aufgelisteten Werkzeuge 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
• Werkzeugnamen unterscheiden zwischen Groß- und Kleinschreibung

Werkzeugfilterung pro Anfrage (HTTP-Header)

Bei Verwendung des Remote-MCP-Servers (HTTP/SSE-Transport) können Sie die verfügbaren Werkzeuge pro Anfrage dynamisch über HTTP-Header filtern. Dies ist nützlich für Clients, die eine feingranulare Kontrolle über die Werkzeugbereitstellung benötigen, ohne den Server neu zu starten.

1. Angegebene Werkzeuge über Header aktivieren (Whitelist):

   • Verwenden Sie den Header X-MCP-Enabled-Tools
   • Nur die aufgelisteten Werkzeuge werden für diese Anfrage aktiviert
   • Beispiel: X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. Angegebene Werkzeuge über Header deaktivieren (Blacklist):

   • Verwenden Sie den Header X-MCP-Disabled-Tools
   • Die aufgelisteten Werkzeuge werden für diese Anfrage deaktiviert
   • Beispiel: X-MCP-Disabled-Tools: create_repo,delete_repo

Prioritätsregeln:

• Wenn sowohl X-MCP-Enabled-Tools als auch X-MCP-Disabled-Tools in derselben Anfrage vorhanden sind, hat die Whitelist (X-MCP-Enabled-Tools) Vorrang
• Werkzeugnamen unterscheiden zwischen Groß- und Kleinschreibung

Beispielkonfiguration für Cursor/Claude:

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

Lizenz

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

Verfügbare Werkzeuge

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

Werkzeug	Kategorie	Beschreibung
list_user_repos	Repository	Vom Benutzer autorisierte Repositories auflisten
get_file_content	Repository	Inhalt einer Datei in einem Repository abrufen
create_repo	Repository	Ein Repository erstellen (Benutzer, Organisation oder Enterprise)
fork_repository	Repository	Ein Repository forken
create_release	Repository	Ein Release für ein Repository erstellen
list_releases	Repository	Repository-Releases auflisten
search_open_source_repositories	Repository	Open-Source-Repositories auf Gitee durchsuchen
search_files_by_content	Repository	Dateien nach Inhalt in einem Repository durchsuchen
compare_branches_tags	Repository	Zwei Branches, Tags oder Commits in einem Repository vergleichen
list_repo_pulls	Pull Request	Pull Requests in einem Repository auflisten
merge_pull	Pull Request	Einen Pull Request mergen
create_pull	Pull Request	Einen Pull Request erstellen
update_pull	Pull Request	Einen Pull Request aktualisieren
get_pull_detail	Pull Request	Details eines Pull Requests abrufen
get_diff_files	Pull Request	Diff-Dateien eines Pull Requests abrufen
manage_pull_review	Pull Request	Ein Pull-Request-Review verwalten (genehmigen oder abbrechen)
create_comment	Kommentar	Einen Kommentar zu einem Issue oder Pull Request erstellen
list_comments	Kommentar	Alle Kommentare für ein Issue oder einen Pull Request auflisten
create_issue	Issue	Ein Issue erstellen
update_issue	Issue	Ein Issue aktualisieren
get_repo_issue_detail	Issue	Details eines Repository-Issues abrufen
list_repo_issues	Issue	Repository-Issues auflisten
get_user_info	Benutzer	Informationen des aktuell authentifizierten Benutzers abrufen
search_users	Benutzer	Nach Benutzern suchen
list_user_notifications	Benachrichtigung	Benutzerbenachrichtigungen auflisten

Mitwirken

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 Ihre Fehlerbehebung.
3. Nehmen Sie Ihre Änderungen vor und stellen Sie sicher, dass der Code gut dokumentiert ist.
4. Reichen Sie einen Pull Request mit einer klaren Beschreibung Ihrer Änderungen ein.

Weitere Informationen finden Sie in der CONTRIBUTING-Datei.