Gitee

Server MCP Gitee

Server MCP Gitee adalah implementasi server Model Context Protocol (MCP) untuk Gitee. Server ini menyediakan serangkaian alat untuk berinteraksi dengan API Gitee, memungkinkan asisten AI mengelola repositori, isu, pull request, dan lainnya.

Fitur

• Berinteraksi dengan repositori, isu, pull request, dan notifikasi Gitee
• URL dasar API yang dapat dikonfigurasi untuk mendukung berbagai instansi Gitee
• Bendera baris perintah untuk konfigurasi yang mudah
• Mendukung operasi pribadi, organisasi, dan perusahaan
• Mengaktifkan/menonaktifkan set alat secara dinamis

Skenario praktis: Dapatkan Isu dari repositori, implementasikan dan buat Pull Request

1. Dapatkan Isu repositori
2. Implementasikan pengkodean & buat Pull Request berdasarkan detail Isu
3. Komentari & Tutup Isu

Instalasi (Langkah ini dapat dilewati langsung saat memulai npx)

Prasyarat

• Go 1.23.0 atau lebih tinggi
• Akun Gitee dengan token akses, Dapatkan di sini

Membangun dari Sumber

1. Kloning repositori:

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

2. Bangun proyek:

   make build
   

   Pindahkan ./bin/mcp-gitee ke PATH env

Gunakan go install

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

Penggunaan

Periksa versi mcp-gitee:

mcp-gitee --version

Konfigurasi Host MCP

Contoh konfigurasi: Klik untuk melihat lebih banyak konfigurasi aplikasi

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

Server MCP Jarak Jauh

Hubungkan ke server mcp-gitee jarak jauh resmi (tidak perlu instalasi):

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

Codex menggunakan ~/.codex/config.toml:

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

opencode menggunakan ~/.config/opencode/opencode.json:

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

Opsi Baris Perintah

• --token: Token akses Gitee
• --api-base: URL dasar API Gitee (default: https://gitee.com/api/v5)
• --version: Tampilkan informasi versi
• --transport: Tipe transport (stdio, sse, atau http, default: stdio)
• --address: Host dan port untuk memulai server (default: localhost:8000)
• --enabled-toolsets: Daftar alat yang dipisahkan koma untuk diaktifkan (jika ditentukan, hanya alat ini yang akan diaktifkan)
• --disabled-toolsets: Daftar alat yang dipisahkan koma untuk dinonaktifkan

Variabel Lingkungan

Anda juga dapat mengonfigurasi server menggunakan variabel lingkungan:

• GITEE_ACCESS_TOKEN: Token akses Gitee
• GITEE_API_BASE: URL dasar API Gitee
• ENABLED_TOOLSETS: Daftar alat yang dipisahkan koma untuk diaktifkan
• DISABLED_TOOLSETS: Daftar alat yang dipisahkan koma untuk dinonaktifkan

Manajemen Set Alat

Manajemen set alat mendukung dua mode:

1. Aktifkan alat tertentu (mode daftar putih):

   • Gunakan parameter --enabled-toolsets atau variabel lingkungan ENABLED_TOOLSETS
   • Setelah ditentukan, hanya alat yang terdaftar yang akan diaktifkan, yang lain akan dinonaktifkan
   • Contoh: --enabled-toolsets="list_user_repos,get_file_content"

2. Nonaktifkan alat tertentu (mode daftar hitam):

   • Gunakan parameter --disabled-toolsets atau variabel lingkungan DISABLED_TOOLSETS
   • Setelah ditentukan, alat yang terdaftar akan dinonaktifkan, yang lain akan diaktifkan
   • Contoh: --disabled-toolsets="list_user_repos,get_file_content"

Catatan:

• Jika enabled-toolsets dan disabled-toolsets keduanya ditentukan, enabled-toolsets yang diutamakan
• Nama alat bersifat case-sensitive

Pemfilteran Alat Per Permintaan (Header HTTP)

Saat menggunakan server MCP jarak jauh (transport HTTP/SSE), Anda dapat memfilter alat yang tersedia secara dinamis per permintaan melalui header HTTP. Ini berguna untuk klien yang memerlukan kontrol terperinci atas eksposur alat tanpa memulai ulang server.

1. Aktifkan alat tertentu melalui header (daftar putih):

   • Gunakan header X-MCP-Enabled-Tools
   • Hanya alat yang terdaftar yang akan diaktifkan untuk permintaan tersebut
   • Contoh: X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. Nonaktifkan alat tertentu melalui header (daftar hitam):

   • Gunakan header X-MCP-Disabled-Tools
   • Alat yang terdaftar akan dinonaktifkan untuk permintaan tersebut
   • Contoh: X-MCP-Disabled-Tools: create_repo,delete_repo

Aturan prioritas:

• Jika X-MCP-Enabled-Tools dan X-MCP-Disabled-Tools keduanya ada dalam permintaan yang sama, daftar putih (X-MCP-Enabled-Tools) yang diutamakan
• Nama alat bersifat case-sensitive

Contoh konfigurasi untuk 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"
      }
    }
  }
}

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT. Lihat file LICENSE untuk detail lebih lanjut.

Alat yang Tersedia

Server menyediakan berbagai alat untuk berinteraksi dengan Gitee:

Alat	Kategori	Deskripsi
list_user_repos	Repositori	Daftar repositori yang diotorisasi pengguna
get_file_content	Repositori	Dapatkan konten file dalam repositori
create_repo	Repositori	Buat repositori (pengguna, org, atau perusahaan)
fork_repository	Repositori	Fork repositori
create_release	Repositori	Buat rilis untuk repositori
list_releases	Repositori	Daftar rilis repositori
search_open_source_repositories	Repositori	Cari repositori sumber terbuka di Gitee
search_files_by_content	Repositori	Cari file berdasarkan konten dalam repositori
compare_branches_tags	Repositori	Bandingkan dua cabang, tag, atau komit dalam repositori
list_repo_pulls	Pull Request	Daftar pull request dalam repositori
merge_pull	Pull Request	Gabungkan pull request
create_pull	Pull Request	Buat pull request
update_pull	Pull Request	Perbarui pull request
get_pull_detail	Pull Request	Dapatkan detail pull request
get_diff_files	Pull Request	Dapatkan file diff pull request
manage_pull_review	Pull Request	Kelola tinjauan pull request (setujui atau batalkan)
create_comment	Komentar	Buat komentar pada isu atau pull request
list_comments	Komentar	Daftar semua komentar untuk isu atau pull request
create_issue	Isu	Buat isu
update_issue	Isu	Perbarui isu
get_repo_issue_detail	Isu	Dapatkan detail isu repositori
list_repo_issues	Isu	Daftar isu repositori
get_user_info	Pengguna	Dapatkan informasi pengguna terautentikasi saat ini
search_users	Pengguna	Cari pengguna
list_user_notifications	Notifikasi	Daftar notifikasi pengguna

Kontribusi

Kami menyambut kontribusi dari komunitas sumber terbuka! Jika Anda ingin berkontribusi pada proyek ini, silakan ikuti panduan ini:

1. Fork repositori.
2. Buat cabang baru untuk fitur atau perbaikan bug Anda.
3. Lakukan perubahan Anda dan pastikan kode terdokumentasi dengan baik.
4. Kirim pull request dengan deskripsi yang jelas tentang perubahan Anda.

Untuk informasi lebih lanjut, silakan merujuk ke file CONTRIBUTING.