Alibaba Cloud DevOps MCP Server (alibabacloud-devops-mcp-server), yapay zeka asistanlarının Alibaba Cloud DevOps platformu ile etkileşim kurmasını sağlar. Yapay zeka asistanları projelerdeki iş öğesi içeriğini okuyabilir, gereksinimleri anlayabilir, kodu otomatik olarak yazabilir ve birleştirme isteklerini gönderebilir. Ar-Ge ekipleri bu aracı kod incelemelerine yardımcı olmak, görev yönetimini optimize etmek ve tekrarlayan işlemleri azaltmak için kullanır; böylece inovasyona ve ürün teslimatına odaklanabilirler. Alibaba Cloud DevOps MCP Server açık kaynaklı bir projedir. Kaynak kodu: https://github.com/aliyun/alibabacloud-devops-mcp-server.
Özellikler
Bağlantıyı kurduktan sonra yapay zeka asistanlarına (Cursor, Claude ve Tongyi Lingma gibi) doğal dil kullanarak iş öğelerini kontrol etme, kodu okuma, birleştirme istekleri gönderme ve işlem hatlarını çalıştırma talimatları verebilirsiniz. Aşağıdaki yetenekler desteklenir:
Kuruluş yönetimi: Kuruluş listesi, kuruluş bilgileri, departman bilgileri, kuruluş rolleri, üye bilgileri vb.
Kod yönetimi (Codeup): Kod depoları, dallar, birleştirme istekleri, dosya ağaçları vb.
Proje iş birliği (Projex): Projeler, iş öğeleri, iş öğesi alanları, yorumlar, çalışma saati yönetimi vb.
İşlem hattı yönetimi (Flow): İşlem hatları, görevler, kaynaklar, etiketler, dağıtım yönetimi vb.
Yapıt deposu (Packages): Yapıt depoları, yapıt listesi vb.
Uygulama dağıtımı (AppStack): Dağıtım siparişleri, uygulamalar, uygulama etiketleri, değişken grubu yönetimi vb.
Test yönetimi (Testhub): Test senaryoları, test senaryosu dizinleri, test planları, test sonuçları vb.
Ön Koşullar
Kişisel erişim belirteci edinin ve belirtece Kuruluş Yönetimi, Proje İş Birliği, Kod Yönetimi, İşlem Hattı, Yapıt Deposu, Uygulama Dağıtımı ve Test Yönetimi altındaki tüm API'ler için okuma ve yazma izinleri verin. Belirteç için yeterince uzun bir sona erme süresi ayarlayın.
OAuth 2.0 yetkilendirmesi: MCP istemciniz OAuth'u destekliyorsa önceden bir belirteç oluşturmanız gerekmez. Uzaktan barındırma URL'sini yapılandırdıktan sonra istemci, tarayıcı aracılığıyla oturum açmanıza ve yetkilendirme yapmanıza rehberlik eder. Ayrıntılar için aşağıdaki "Gelişmiş yapılandırma > Kimlik doğrulama yöntemleri > OAuth 2.0 Yetkilendirmesi" bölümüne bakın.
(Yalnızca stdio modu) Node.js sürümü >= 20.0.0.
Erişim yöntemleri
Alibaba Cloud DevOps MCP Server iki erişim yöntemi destekler: Uzaktan Barındırma (Streamable HTTP) ve Yerel (stdio). Uzaktan Barındırma bağımlılık yüklemesi gerektirmez; yalnızca yapılandırıp kullanmanız yeterlidir. Yerel mod bir Node.js ortamı gerektirir ve hizmeti çekip başlatmak için npx kullanır. Aşağıdaki hizmet adresleri merkezi istasyon örneği kullanılarak verilmiştir. Bölge istasyonları için adresi kuruluşunuza özel etki alanınız + /ai/mcp ile değiştirin. Ayrıntılar için aşağıdaki "Bölge yapılandırması (Adanmış Sürüm)" bölümüne bakın.
Uzaktan barındırma (Streamable HTTP)
<YOUR_TOKEN> ifadesini kişisel erişim belirtecinizle değiştirin:
{
"mcpServers": {
"yunxiao": {
"url": "https://openapi-rdc.aliyuncs.com/ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}
İstemciniz özel headers değerlerini desteklemiyorsa belirteci iletmek için bunun yerine Sorgu Dizesi kullanabilirsiniz: https://openapi-rdc.aliyuncs.com/ai/mcp?yunxiao_access_token=<YOUR_TOKEN>.
İstemciniz OAuth'u destekliyorsa belirteci atlayıp bunun yerine tarayıcı tabanlı yetkilendirmeyi kullanabilirsiniz. Ayrıntılar için aşağıdaki "Gelişmiş yapılandırma > Kimlik doğrulama yöntemleri > OAuth 2.0 Yetkilendirmesi" bölümüne bakın.
Yerel (stdio)
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": ["-y", "alibabacloud-devops-mcp-server"],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
Kullanım
Bağlantıyı başarıyla kurduktan sonra yapay zekaya doğal dil kullanarak talimat verin. Örneğin:
"Ait olduğum kuruluşları listele"
"xxx kuruluşundaki repo-name deposunun master dalındaki en son 10 commit'i göster"
"Mevcut daldan master'a başlığı ... olan bir birleştirme isteği oluştur"
"yyy projesinde bana atanmış tamamlanmamış iş öğelerini göster"
"#12345 numaralı iş öğesine bir yorum ekle: entegrasyon testi tamamlandı"
"Hangi işlem hattı en yakın zamanda başarısız oldu? Başarısızlık günlüklerini getir"
Yapay zeka uygun araçları otomatik olarak seçer ve kimlik bilgilerinizle çalıştırır.
Gelişmiş yapılandırma
Araç kümesi filtreleme
Alibaba Cloud DevOps MCP Server, 8 kategoride 194 araç sağlar. Çok fazla araç önemli miktarda model bağlamı tüketebilir. Yalnızca belirli kategorilere ihtiyacınız varsa sunucunun yalnızca ilgili araçları sunmasını sağlamak için araç kümelerini belirtebilirsiniz (temel araçlar her zaman dahil edilir).
Uzaktan Barındırma modu: URL'ye
?toolsets=...ekleyin veyaX-Devops-Toolsets: ...istek üstbilgisini ekleyin.stdio modu:
--toolsets=...komut satırı bağımsız değişkenini ekleyin veyaDEVOPS_TOOLSETS=...ortam değişkenini ayarlayın.
Kullanılabilir değerler (virgülle ayrılmış): code-management, organization-management, project-management, pipeline-management, packages-management, application-delivery, test-management. Belirtilmezse varsayılan olarak tüm araçlar etkinleştirilir.
Uzaktan erişim örneği:
{
"mcpServers": {
"yunxiao": {
"url": "https://openapi-rdc.aliyuncs.com/ai/mcp?toolsets=code-management,project-management",
"headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
}
}
}
Kimlik doğrulama yöntemleri
Alibaba Cloud DevOps MCP Server iki tür kimlik doğrulamayı destekler: manuel olarak Kişisel Erişim Belirteci (PAT) iletme veya desteklenen istemcilerin belirteç olmadan bağlanması için OAuth 2.0 yetkilendirmesi kullanma.
Kişisel Erişim Belirteci (PAT) Kullanma
Kişisel erişim belirtecini iletmek için önerilen öncelik sırasına göre listelenen aşağıdaki üç yöntem kullanılabilir:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
stdio modunda belirteci YUNXIAO_ACCESS_TOKEN ortam değişkeni aracılığıyla iletin. Yukarıdaki yapılandırmalara gerek yoktur.
OAuth 2.0 Yetkilendirmesi
Qoder/QoderCLI ve Claude Code gibi OAuth'u destekleyen MCP istemcileri için önceden kişisel erişim belirteci oluşturmanız gerekmez. Uzaktan Barındırma modunda hizmet URL'sini girdikten sonra istemci otomatik olarak OAuth 2.0 yetkilendirme kodu + PKCE akışını başlatır, oturum açmanız ve yetkilendirme yapmanız için bir tarayıcı açar, ardından belirteçleri otomatik olarak alır ve yeniler. Bu durum Uzaktan Barındırma (Streamable HTTP) erişimi için geçerlidir.
Yapılandırırken yalnızca hizmet URL'sini girin, Authorization üstbilgisini eklemeyin:
{
"mcpServers": {
"yunxiao": {
"url": "https://openapi-rdc.aliyuncs.com/ai/mcp"
}
}
}
Hizmet URL'si: Merkezi istasyon
https://openapi-rdc.aliyuncs.com/ai/mcp; Bölge istasyonuhttps://<organization-specific-domain>/ai/mcp.Uç nokta keşfi, istemci kaydı ve PKCE işlemlerinin tümü istemci tarafından otomatik olarak yürütülür. Manuel olarak bir
client_idbaşvurusunda bulunmanız veya birclient_secretyapılandırmanız gerekmez (platform genel istemciler kullanır).Yetkilendirmeden sonra verilen erişim belirteçleri 24 saat, yenileme belirteçleri ise 90 gün geçerlidir. İstemci belirteçleri otomatik olarak yeniler. Yenileme belirtecinin süresi dolduktan sonra yeniden yetkilendirme gerekir.
Bölge yapılandırması (Adanmış Sürüm)
Bir Alibaba Cloud DevOps Bölge istasyonu kullanıyorsanız her Bölge bağımsız olarak resmi olarak barındırılan bir MCP uç noktası sağlar. Kullanım merkezi istasyonla aynıdır; yalnızca hizmet adresini kuruluşunuza özel etki alanınızla değiştirin.
Yöntem 1: Uzaktan Barındırma (Streamable HTTP, önerilir, kurulum gerekmez)
Hizmet adresi:
https://<organization-specific-domain>/ai/mcp, örneğinhttps://your-org.devops.aliyuncs.com/ai/mcp(normal Alibaba Cloud DevOps Bölge etki alanınıza/ai/mcpeklenmiş hali)Kimlik doğrulama:
Authorization: Bearer <YOUR_TOKEN>(veyaX-Yunxiao-Token: <YOUR_TOKEN>). İstemciniz OAuth'u destekliyorsa belirteci atlayıp bunun yerine tarayıcı tabanlı yetkilendirmeyi kullanabilirsiniz. Ayrıntılar için yukarıdaki "Gelişmiş yapılandırma > Kimlik doğrulama yöntemleri > OAuth 2.0 Yetkilendirmesi" bölümüne bakın.
{
"mcpServers": {
"yunxiao": {
"url": "https://your-org.devops.aliyuncs.com/ai/mcp",
"headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
}
}
}
Yöntem 2: Yerel (stdio)
Bölge etki alanınızı işaret etmek için YUNXIAO_API_BASE_URL ortam değişkenini kullanın:
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": ["-y", "alibabacloud-devops-mcp-server"],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>",
"YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
}
}
}
}
Kendi kendine dağıtım ve geliştirici belgeleri
Yerel veya özel bir ortamda (stdio / SSE / Streamable HTTP) dağıtmak, Docker ile çalıştırmak veya projenin uygulama ayrıntıları hakkında bilgi edinmek için GitHub'daki tam belgelere bakın:
Proje ana sayfası ve tam README: https://github.com/aliyun/alibabacloud-devops-mcp-server
İlgili bağlantılar
Sorularınız için DingTalk üzerindeki Alibaba Cloud DevOps yapay zeka asistanı tartışma grubuna katılın (grup numarası: 134400004101).