İçeriğe atla

MCP API Referansı

Maguyva ürününün 11 MCP aracını, parametrelerini ve kullanım alanlarını keşfedin. Kullanabileceğiniz bağımsız değişkenler için bağlı istemcinizin tools/list yanıtını kontrol edin.

API Genel Bakış

#

Araçlar 4 kategoride düzenlenmiştir:

  • Temel Arama Araçları - Kod tabanınız genelinde gelişmiş arama yetenekleri
  • Yapısal ve Graf Araçları - AST sorguları, sembol sorgulama ve bağımlılık analizi
  • Kod Analizi Araçları - Derin kod analizi ve ilişki haritalama
  • Sistem ve Yardımcı Araçlar - Repo bağlamı, araç rehberliği ve geri bildirim

Repo kabul eden araçlarda şu repo tanımlayıcı biçimi biçimini kullanın: "owner/repo:branch". Belirtilmezse dal varsayılan olarak main olur.

MCP istemciniz bir istek varsayılanı sağladığında veya anahtar tam olarak bir repoya erişebildiğinde repository öğesini atlayın; aksi halde açıkça iletin. Bir reponun nasıl çözümlendiğini incelemek için repository_context(action="info", repository="owner/repo") kullanın.

Repo Parametresi Biçimi

#

Repo belirtirken şu biçimleri kullanın:

  • Dal ile: "owner/repo:branch" - örn., "owner/repository:develop"
  • Varsayılan dal: "owner/repo" - dal belirtilmezse main dalı kullanılır "owner/repository"
  • İstek varsayılanı veya erişilebilen tek repo: MCP istemcisi istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa repository değerini belirtmeyin; aksi halde açıkça gönderin.

Örnek promptlar:

Belirli bir repo hakkında sorun:    "owner/my-repo içinde kimlik doğrulama ara yazılımını ara"
Erişilebilir repoları listeleyin:   "Bu Maguyva anahtarı hangi repolara erişebilir?"
Tek bir sorgu için geçersiz kılın:  "owner/other-repo:develop içinde kimlik doğrulama kalıplarını ara"

Dil Filtreleme

#

Desteklenen arama modlarında language_filter kullanın. text_pattern_search için search_scope="content" seçin; get_task_context için başlangıç noktaları veya ilgili bağlam olmadan scope="semantic" kullanın.

  • language_filter="python" - Yalnızca Python dosyalarına filtrele
  • language_filter="typescript" - Yalnızca TypeScript dosyalarına filtrele
  • Büyük/küçük harf duyarlı: Küçük harfli dil isimleri kullanın
  • Varsayılan: Boş dize (filtreleme yok) - tüm dillerden sonuç döner
  • Desteklenen kapsam: Dil filtreleri, desteklenen 285+ dil ve metin tabanlı teknoloji genelinde çalışır. Tam liste için uyumluluk sayfasına bakın. 
"Yalnızca Python dosyalarında kimlik doğrulama ara katmanını bul"
"TypeScript'te veritabanı bağlantılarını ara"

API referansı 21 Ekim 2026 tarihinde kaynaktan üretildi.

Temel Arama Araçları

#

intelligent_search Kararlı

Kod tabanıyla ilgili her türlü soru için buradan başlayın. Varsayılan auto/balanced, tanım aradığı yüksek güvenle belirlenen sorguları yapısal aramaya, referans veya etki sorgularını grafa, tam eşleşme sorgularını ise metin aramasına yönlendirir. Diğer sorgular anlamsal anlamı ve dizinlenmiş metni kullanır. Dört arama yönteminin tümünü istemek için mode=hybrid veya quality=thorough ile auto kullanın; açıkça belirtilen mod, quality ayarından önce gelir. language_filter, grafı auto/hybrid kapsamından çıkarır ve açıkça belirtilen mode=graph seçeneğini reddeder. Yolu henüz bilmiyorsanız Grep/Glob yerine bunu tercih edin.

Parametreler:

query Zorunlu
Tür
str minLength=1
Açıklama
Arama sorgusu
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
mode Opsiyonel
Tür
Literal[auto, hybrid, semantic, text, structural, ast, graph]
Varsayılan
auto
Açıklama
Arama modu
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
10
Açıklama
Bu sıralı top-K penceresindeki maksimum sonuç sayısı
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi
path_filter Opsiyonel
Tür
str
Açıklama
Arama adaylarını dosya yolu önekine göre filtreler. Grafın komşu düğümleri ve eklenen topluluk bağlamı, bu önekin dışında kalan dosyaları içerebilir.
boost_by_importance Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Opsiyonel: sembol başına graph metrikleri (is_articulation_point, bridge_count, k_core, centrality, vb.) kullanarak centrality'ye göre yeniden sırala. Agent-safe sıralama için varsayılan olarak kapalıdır (global hub'lar implementation sonuçlarını gölgede bırakabilir); mimari turlar için etkinleştirin. Her sonuç symbol linkage taşıdığında 4 modalitenin tümünde geçerlidir.
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
quality Opsiyonel
Tür
Literal[quick, balanced, thorough]
Varsayılan
balanced
Açıklama
Arama kalite ön ayarı
include_content Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Sonuçlara içeriği dahil et
explain_routing Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Yönlendirme kararı açıklamasını dahil et
importance_weight Opsiyonel
Tür
float minimum=0, maximum=1
Varsayılan
0.3
Açıklama
Önem güçlendirmesi ağırlığı (0=yok, 1=tam)
orphans Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Öksüz sembolleri dahil et (gelen referans yok)
include_community_context Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Aynı kod topluluğundan ilgili sembolleri dahil et
community_depth Opsiyonel
Tür
int minimum=1, maximum=3
Varsayılan
1
Açıklama
Topluluk bağlamı genişletme derinliği
graph_view Opsiyonel
Tür
Literal[dependency, type, data_flow, control_flow]
Varsayılan
dependency
Açıklama
Metrikler için graf görünümü
seed_symbol_ids Opsiyonel
Tür
list[str] maxItems=20
Açıklama
Birinci öncelikli görev başlangıç noktaları: mevcut görevin merkezindeki sembol kimlikleri. Verildiğinde, birleştirilmiş sonuçları Approach A derinlik azalmalı yakınlık ölçüsüne göre yeniden sıralar (başlangıç noktasıyla tam eşleşme + graf kenarı adımları). Mevcut sıralamayı tamamlayan ek bir sinyaldir — genel sıralama için belirtmeyin.
seed_file_paths Opsiyonel
Tür
list[str] maxItems=10
Açıklama
Birinci öncelikli görev başlangıç noktaları: ajanın açık tuttuğu veya az önce düzenlediği dizinlenmiş dosya yolları. Verildiğinde, birleştirilmiş sonuçları 1/(1+d) derinlik azalmasıyla yol yakınlığına göre yeniden sıralar (aynı dosya → aynı klasör → yakındaki paketler). Mevcut sıralamayı tamamlayan ek bir sinyaldir — genel sıralama için belirtmeyin.

En İyi Kullanım:

  • Doğru tool'un belirsiz olduğu index genelinde veya cold-start keşifler
  • Semantic, text, structural ve graph arasında multi-modal, birleşik ranking

Önerilmeyen Kullanım:

  • Bilinen bir symbol adı — doğrudan find_symbol kullanın
  • Diskte bilinen bir path — önce yerel Read/Grep kullanın

semantic_search Kararlı

Kodu tam metne göre değil, anlama göre bulun. Anahtar sözcük veya sembol adı bilinmediğinde 'yeniden deneme mantığı' veya 'kullanıcı başlangıç akışı' gibi kavramsal sorgularda kullanın. Dosya çeşitliliği sınırlandırılmış ilgili parçalar döndürür; graf önemine göre yeniden sıralama boost_by_importance ile isteğe bağlı açılır. Kavramsal aramada Grep yerine tercih edin.

Parametreler:

query Zorunlu
Tür
str minLength=1
Açıklama
Arama sorgusu (kavramsal, anlama dayalı)
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
5
Açıklama
Bu sıralı top-K penceresindeki maksimum sonuç sayısı
similarity_threshold Opsiyonel
Tür
float minimum=0, maximum=1
Varsayılan
0.6
Açıklama
Minimum benzerlik skoru
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi (python, typescript, vb.)
path_filter Opsiyonel
Tür
str
Açıklama
Dosya yolu önekine göre filtrele
boost_by_importance Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
İsteğe bağlı: her sembolün normalize edilmiş graf önemine göre yeniden sıralar (varsayılan kapalı; benzerliğin 1,5 katıyla sınırlı).
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma (varsayılan: repository parametresinden veya main)
include_content Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Parça içeriğini sonuçlara dahil et
graph_view Opsiyonel
Tür
Literal[dependency, type, data_flow, control_flow]
Varsayılan
dependency
Açıklama
Metrikler için graph view

En İyi Kullanım:

  • Kavramsal sorgular ("how does auth work?", "caching strategy")
  • Paketler arası benzerlik araması

Önerilmeyen Kullanım:

  • Bilinen bir symbol adı — bunun yerine find_symbol kullanın
  • Tam metinler veya hata mesajları — text_pattern_search kullanın

text_pattern_search Kararlı

Dizinlenmiş içeriği arayın. exact ve regex tüm dosya/blob derleminde grep kullanır; fuzzy content sınırlı anlamsal parça derlemini arar. file ve symbol kapsamları yalnızca trigram destekler; varsayılan mode=exact, fuzzy olarak dönüştürülür. Dil, harf duyarlılığı ve özel eşik kontrolleri content kapsamı gerektirir. Dosya yolu filtresi sınırlı aday penceresi kullanır ve eksik kapsamı bildirir. Diskteki dar kapsamlı bir klasör için yerel Grep kullanın.

Parametreler:

query Zorunlu
Tür
str minLength=1
Açıklama
Aranacak metin kalıbı
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
mode Opsiyonel
Tür
Literal[fuzzy, exact, regex]
Varsayılan
exact
Açıklama
Arama modu. Regex, PostgreSQL'in gelişmiş/POSIX söz dizimini çalıştırır; sözcük sınırları için \y kullanın (\b geri silme anlamına gelir). Desenler ayrıca bir JavaScript güvenlik doğrulayıcısından geçer, bu nedenle satır içi (?i) bayrakları gibi yalnızca PostgreSQL'e özgü yapılar reddedilir; bunun yerine case_sensitive kullanın.
search_scope Opsiyonel
Tür
Literal[content, symbols, files]
Varsayılan
content
Açıklama
Ne aranacak
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
5
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi
path_filter Opsiyonel
Tür
str
Açıklama
Dosya yolu önekine göre filtrele
case_sensitive Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Büyük/küçük harfe duyarlı eşleşme
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
fuzzy_algorithm Opsiyonel
Tür
Literal[hybrid, trigram, levenshtein]
Varsayılan
hybrid
Açıklama
Bulanık eşleşme algoritması
threshold Opsiyonel
Tür
float minimum=0, maximum=1
Varsayılan
0.05
Açıklama
Bulanık için minimum benzerlik eşiği
semantic_fallback Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
İlk sözcüksel sayfa boş döndüğünde semantic search dener; metadata.fallback_status used, empty ve unavailable fallback durumlarını ayırt eder.

En İyi Kullanım:

  • Tam metinler, hata mesajları ve regex
  • Yakın eşleşen metinler için trigram fuzzy eşleştirme

Önerilmeyen Kullanım:

  • Diskte bilinen bir path — yerel Grep'i tercih edin
  • Kavramsal sorgular — semantic_search kullanın

Yapısal ve Graf Araçları

#

structural_search Kararlı

preset=functions|classes|methods|imports|variables veya serbest pattern= tercih edin. Kodu metne değil AST biçimine göre bulun. Orta düzey filtreler: name_pattern, node_type, decorator, parent_child. Yol, ltree ve çağrı filtreleri gelişmiştir; bilinçli kullanırken advanced=true ayarlayın. Bu ayar olmadan da gelişmiş filtreler uygulanır, ancak meta veride uyarı verilir. En az bir yapısal seçici sağlayın.

Parametreler:

repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
preset Opsiyonel
Tür
Literal[functions, classes, methods, imports, variables]
Açıklama
Tercih edilen structural selector. Diller arası AST node türlerine genişler — functions (dillerdeki function/arrow/method tanımları); classes (class/struct/interface bildirimleri, tür gövdeleri ve uygulamalar); methods (method tanımları (method node'u olmayan diller için function_definition dahil)); imports (import/use/include ifadeleri); variables (variable/let/const/static bildirimleri). Browse tarzı sorgular için serbest biçimli pattern/node_type yerine bunu tercih edin.
pattern Opsiyonel
Tür
str
Açıklama
Serbest biçimli pattern eksik seçicileri tamamlar (otomatik algılama: 'def foo(' → node_type + name_pattern). preset ile birleştirilebilir; açık seçiciler önceliklidir. Gezinme sorgularında preset= tercih edin.
name_pattern Opsiyonel
Tür
str maxLength=256
Açıklama
Symbol adı pattern'i (shell wildcard, sınırlı POSIX regex veya fuzzy metin; en fazla 256 karakter)
node_type Opsiyonel
Tür
str
Açıklama
AST node türü (function_definition, class_definition, vb.) — yaygın şekiller için preset= tercih edin
decorator Opsiyonel
Tür
str
Açıklama
Dekoratör adı filtresi
base_class Opsiyonel
Tür
str
Açıklama
Temel sınıf filtresi
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi (python, typescript, vb.)
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
20
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.
path_filter Opsiyonel
Tür
str
Açıklama
Dosya yolu önekine göre filtrele
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
query_type Opsiyonel
Tür
Literal[node_type, name_pattern, parent_child]
Açıklama
Açık sorgu türü
parent_type Opsiyonel
Tür
str
Açıklama
Üst AST düğüm türü filtresi
relationship Opsiyonel
Tür
Literal[parent, ancestor]
Varsayılan
parent
Açıklama
parent_child sorguları için: yalnızca doğrudan ebeveyn veya herhangi bir ata (sınıf gövdesi içindeki yöntemler için ancestor kullanın)
has_modifier Opsiyonel
Tür
str
Açıklama
Modifier ile filtrele (export, async, static, vb.)
advanced Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Gelişmiş yol, ltree veya çağrı filtrelerini bilinçli kullanırken true ayarlayın (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). false olduğunda verilen gelişmiş filtreler meta veri uyarısıyla uygulanır. Yaygın yapısal sorgularda preset= tercih edin.
callee_text Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Call expression callee metin filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
callee_name Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Call expression callee adı filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
field_role Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. AST field role filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
ltree_ancestor Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. AST ltree ancestor path filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
ltree_descendant Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. AST ltree descendant path filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
definition_name Opsiyonel
Tür
str
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Definition adı filtresi. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
min_depth Opsiyonel
Tür
int
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Minimum AST derinliği. Yol/ltree/çağrı filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
max_depth Opsiyonel
Tür
int
Açıklama
Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Maksimum AST derinliği. Yol/ltree/çağrı filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.

En İyi Kullanım:

  • AST seviyesinde yapı: class'lar, decorator'lar, function/method preset'leri
  • Kodu metne göre değil, şekline göre bulma

Önerilmeyen Kullanım:

  • Serbest metin veya kavramsal sorgular — semantic_search ya da intelligent_search kullanın

dependency_search Kararlı

Birincil etki yarıçapı / graph yüzeyi. Gerçek call/import graph'ı üzerinden "bunu ne çağırıyor?" / "bu neyi kullanıyor?" sorularını yanıtlar. Edit öncesi etki için: analysis_type="dependents" veya analysis_type="impact" (incoming, impact için varsayılan shallow), include_metrics varsayılan olarak false'tur (centrality + refactor_risk için opt-in). PR/diff etkisi: changed_paths ve/veya patch (unified diff) geçirin — her path için symbol'leri çözer ve symbol adı gerektirmeden kompakt bir shallow-incoming dependents payload'ı döndürür. Bir edit'ten sonra, etkilenen symbol'lerin kompakt multi-root yeniden sorgusu için targets ve/veya changed_paths ile verify_after_edit=true ayarlayın. Ayrıca dependencies, centrality ve orphans'ı da destekler. analyze_dependencies, çok adımlı etki analizi için aynı dolaşımı kullanır. dependents/impact varsayılan olarak production_callers içerir: türe göre benzersiz üretim kullanım noktaları (call, instantiate, değer olarak geçirilen işlevler için value_reference) ve IMPORT noktaları; testler hariçtir ve EXTRACTED/INFERRED güven düzeyi belirtilir — salt metrik dökümü değildir.

Parametreler:

repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
query Opsiyonel
Tür
str
Açıklama
Sembol adı veya arama terimi
target Opsiyonel
Tür
str
Açıklama
Sembol adı (query için takma ad)
symbol_id Opsiyonel
Tür
UUID
Açıklama
Ad alanı, yol ve dil filtrelemesinden sonra query/target içinde belirtilen ada ait adaylar arasından UUID ile belirli bir oluşumu seçin. find_symbol veya grafın alternatif sonuçlarından dönen bir ID kullanın. Yalnızca adı belirtilen dolaşımlar için geçerlidir; sınırlı aday penceresinin dışındaki bir ID hataya yol açar.
changed_paths Opsiyonel
Tür
list[str] maxItems=50
Açıklama
PR/diff etki analizi için (varsayılan) veya verify_after_edit=true olduğunda düzenleme sonrası doğrulamanın başlangıç noktaları için repo köküne göre tam göreli dosya yolları. Çözümlenemeyen yollar etiketli öneriler döndürebilir; önerilen dosyalar hiçbir zaman etki başlangıç noktası olmaz. PR/diff: satır bilgisi yoksa her yolun üst düzey tanımlarını (önce dışa aktarılanlar, dosya sırasıyla) izler ve changed_lines_unknown bildirir; satır düzeyinde değişen semboller için patch= verin. Doğrulama: başlangıç noktası olarak yol başına en fazla 5 üst düzey tanım (doğrulama modunda bu üst sınır daha düşüktür). PR/diff etki analizi için query/target gerektirmez.
patch Opsiyonel
Tür
str maxLength=500000
Açıklama
PR/diff etki analizi: unified diff / git patch metni. Yollar diff --git / --- / +++ başlıklarından alınır; hunk satırları (eski taraf = dizinlenmiş commit) onları kapsayan fonksiyon, metot ve sınıflarla eşlenir; bunlar izlenerek kesin bağımlılar, public_api_changed ve diff'in dokunmadığı çağıranlar bulunur.
head_commit Opsiyonel
Tür
str pattern=^[0-9a-fA-F]{7,64}$
Açıklama
Sorduğunuz kodun commit SHA'sı (git rev-parse HEAD veya patch'in temel commit'i). complete:true için dizinin bu commit'te olması ve güncel resolver ile oluşturulmuş olması gerekir; aksi halde index_stale / index_freshness_unverified / index_built_by_older_resolver ile complete:false olarak kalır ve index_basis.statement yanıtın hangi kapsamda eksiksiz olduğunu belirtir. Bir patch'in 'base-commit:' satırı (git format-patch --base) da bu değeri sağlar.
analysis_type Opsiyonel
Tür
Literal[centrality, dependencies, dependents, impact, orphans]
Varsayılan
dependencies
Açıklama
Analysis modu. impact = etki yarıçapı (incoming dependents; depth belirtilmediğinde shallow). dependents de impact'i yanıtlar. changed_paths veya patch ayarlandığında analiz PR/diff impact'e zorlanır. centrality/orphans bir target gerektirmez. orphans, kullanılmayan kod adaylarıdır; güvenle kaldırılabileceğinin kanıtı değildir. Kaynaktaki referansları doğrulayın.
depth Opsiyonel
Tür
Literal[shallow, balanced, deep]
Açıklama
Dolaşım derinliği. Varsayılan olarak balanced; impact ve PR/diff impact varsayılan olarak shallow kullanır. Açıkça belirtilen depth bu varsayılanları geçersiz kılar. Doğrulama modu her zaman shallow kullanır.
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
20
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.
path_filter Opsiyonel
Tür
str
Açıklama
Target symbol çözümlemesini file path prefix'ine göre kısıtlar; döndürülen graph ilişkileri bu path'in dışına çıkabilir
language_filter Opsiyonel
Tür
str
Açıklama
Target çözümlemesini ve browse sonuçlarını dile göre filtrele
direction Opsiyonel
Tür
Literal[outgoing, incoming, both]
Açıklama
Dolaşım yönü (analysis_type çıkarımını geçersiz kılar)
relationship_types Opsiyonel
Tür
list[str]
Açıklama
Edge türlerini filtrele (CALL, IMPORT, INHERITS_FROM, vb.). Boş olmayan bir liste graph_view varsayılanlarını geçersiz kılar.
exclude_test_paths Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Varsayılan true: test, fixture, vendor ve örnek path'leri traversal ve centrality sonuçlarından hariç tutar. Bunları dahil etmek için false ayarlayın. Orphan analizi bunu yalnızca dağıtılan backend'in desteklediği yerlerde dikkate alır; aksi halde kendi daha katı noise dışlamalarını korur ve bu ayarlamayı raporlar.
exclude_generated_paths Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Üretilen bildirimlerin yanı sıra derleme, test kapsamı, önbellek, kaynak haritası ve küçültülmüş dosya yollarını dolaşım sonuçlarından hariç tutar
include_module_symbols Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Varsayılan false: from_name veya to_name değeri sentetik __module__ sembolü olan kenarlar (modül düzeyindeki gürültü) hariç tutulur. dependents/dependencies sonuçlarına modül düzeyindeki kenarları dahil etmek için true olarak ayarlayın.
include_isolated Opsiyonel
Tür
bool
Açıklama
Yalnızca orphan analizi için. Varsayılan false. Graph metrik satırı olmayan (hiçbir yerde graph kenarı bulunmayan) sembolleri de döndürmek için true ayarlayın. exclude_test_paths true olduğu sürece stylesheet/markup/veri sembolleri (CSS, HTML, ...), .d.ts bildirimleri ve test/fixture/vendor/example path'leri, backend'in desteklediği yerlerde hariç tutulmaya devam eder; language_filter o dili belirtirse bu geçerli olmaz. TypeScript nesne literal özellikleri yine de yalıtılmış fonksiyonlar olarak görünebilir.
exclude_exported Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Yalnızca sahipsiz semboller için. Varsayılan false: repoda kullanılmayan dışa aktarılan semboller (genel API) is_exported=true ile döndürülür. Yalnızca dahili adaylar için true ayarlayın.
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
per_hop_limit Opsiyonel
Tür
int minimum=1, maximum=300
Açıklama
Hop başına maksimum ilişki sayısı (1-300)
include_metrics Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Sonuç satırlarında opsiyonel graph metrikleri (refactor_risk ile birlikte sıkıştırılmış). min_centrality>0 olduğunda metrikler dahili olarak de alınır ama bu true olmadıkça döndürülmez.
metrics_detail Opsiyonel
Tür
Literal[summary, full]
Varsayılan
summary
Açıklama
include_metrics=true olduğunda: summary (varsayılan), karar sinyallerini ve refactor_risk değerini döndürür; full, seçilmiş metriklerin daha geniş kümesini döndürür
include_edge_metadata Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Ham kenar meta verilerini ve ağırlıklarını dahil eder (büyük veri). Kısa etki analizi yanıtlarında bu seçenek kapalı kalır.
symbol_types Opsiyonel
Tür
list[str]
Açıklama
Döndürülen symbol'leri türe göre filtreler (function, class, method vb.). orphan analizinde desteklenmez; bu durumda path_filter veya language_filter kullanın. Boş liste tür filtresi uygulamaz.
exact_match Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Tam sembol adı eşleşmesi gerektirir
find_similar_patterns Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Benzer kullanım kalıplarını bul
min_centrality Opsiyonel
Tür
float minimum=0
Varsayılan
0
Açıklama
Adlandırılmış sembol gezinmesi ve PR/diff etki analizi için minimum PageRank skoru. centrality/orphans gözatma modlarında sıfırdan büyük eşikler desteklenmez. Metrikler filtreleme için dahili olarak alınır; graph_metrics yalnızca include_metrics=true olduğunda döndürülür. Sabit ve derli toplu denetimler kullanan verify_after_edit tarafından yok sayılır.
graph_view Opsiyonel
Tür
Literal[dependency, type, data_flow, control_flow]
Varsayılan
dependency
Açıklama
Traversal ilişki varsayılanları, metrikler ve centrality sıralaması için kullanılan graph view; orphan analizi tüm view'lar genelinde hesaplanır
verify_after_edit Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Düzenlenen symbol'ler için dizinlenmiş impact grafını tek bir kompakt çok köklü yanıtta yeniden sorgular. targets ve/veya changed_paths (veya target/query) gerektirir. Sabit bir shallow dolaşım ve kompakt bütçeler kullanır; depth/limit/cursor/metrics kontrolleri geçerli değildir. Varsayılan olarak incoming dependents döndürür; sonuçlar dizinlenmiş grafı yansıtır (canlı düzenlemelerin gerisinde kalabilir). true olduğunda, aynı changed_paths için PR/diff impact'e göre önceliklidir.
targets Opsiyonel
Tür
list[str] maxItems=15
Açıklama
verify_after_edit=true olduğunda: yeniden doğrulanacak sembol adları (çağıranlar/bağımlılar). İkisi de sağlanırsa target/query ile birleştirilir.

En İyi Kullanım:

  • Paylaşılan bir symbol'ü düzenlemeden önce etki yarıçapı / impact analizi
  • changed_paths veya patch ile PR/diff impact'i
  • verify_after_edit ile edit sonrası doğrulama

Önerilmeyen Kullanım:

  • Basit metin veya symbol aramaları — text_pattern_search ya da find_symbol kullanın

Kod Analiz Araçları

#

find_symbol Kararlı

Bir fonksiyon, sınıf veya değişkenin tanımlandığı ve kullanıldığı yere atlayın. Adını bildiğinizde (örn. "getCurrentUser") Grep'ten daha hızlı ve hassastır; tüm dizinlenmiş repoyu kapsar. İsteğe bağlı olarak referanslar ve önem metrikleri döndürebilir.

Parametreler:

symbol_name Opsiyonel
Tür
str
Açıklama
Aranacak sembol adı (opsiyonel — metriklere göre gezmek için boş bırakın)
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
scope Opsiyonel
Tür
Literal[definitions, references, both]
Varsayılan
both
Açıklama
Arama kapsamı; references için boş olmayan bir symbol_name gerekir.
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
15
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.
find_similar Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Benzer sembol adlarını dahil et
include_metrics Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Merkeziyet metriklerini dahil et
metrics_detail Opsiyonel
Tür
Literal[summary, full]
Varsayılan
summary
Açıklama
include_metrics=true olduğunda: summary (varsayılan), karar sinyallerini ve refactor_risk değerini döndürür; full, seçilmiş metriklerin daha geniş kümesini döndürür
path_filter Opsiyonel
Tür
str
Açıklama
Dosya yolu önekine göre filtrele
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
symbol_type Opsiyonel
Tür
str minLength=1
Açıklama
Dizinlenmiş sembol türüne göre filtreleyin, örn. function, class, struct, enum veya trait. Bir sembol sonucunun döndürdüğü türü kullanın; tür dile göre değişir.
high_impact Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Mimari açıdan önemli symbol'lere göz atın (symbol_name'i atlayın). Varsayılan mod popularity'dir (utility mega-hub'lar hariç en üst PageRank decile'ı). Articulation/bridge cut-vertex'leri için high_impact_mode=risk ayarlayın.
high_impact_mode Opsiyonel
Tür
Literal[popularity, risk]
Varsayılan
popularity
Açıklama
high_impact=true olduğunda: popularity = yardımcı mega merkezler/modüller hariç, PageRank sıralamasındaki en üst yüzde onluk dilim; risk = önce SMV bridge_count, ardından k_core değerine göre sıralanan eklem noktaları (merkezlerin popülerliği değil, yapısal refactor riski)
in_cycle Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Kayıtlı bağımlılık döngüsü üyeliği olan symbol'lere göre filtreler.
exclude_test_paths Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Graf metriklerine göre göz atarken sıralamadan önce testleri, fixtures'yi, üçüncü taraf kodunu ve örnekleri hariç tutun. Adlandırılmış bir sembole göre arama değişmedi.
reference_views Opsiyonel
Tür
list[Literal[dependency, type, data_flow, control_flow, all]] minItems=1, maxItems=5
Açıklama
Gelen kenarları references/reference_count alanlarını dolduran graf görünümleri (scope references/both). Varsayılan ["dependency", "type"]: çağrılar, içe aktarımlar, dışa aktarımlar, başvurular, örnekleme, kalıtım, geçersiz kılmalar, dekoratörler ve tür kullanımı. data_flow seçilmezse tam olarak çözümlenen data_flow kullanımları (geri çağrılar, işleyiciler, sıralama anahtarları), yalnızca addan çıkarılan eşleşmeler olmadan value_references/value_reference_count olarak ayrı döndürülür. data_flow veya control_flow ekleyin ya da tüm kenar türleri ve katmanları için ["all"] geçirin. Görünüm aileleri dependency_search içindeki graph_view ile aynıdır.
relationship_types Opsiyonel
Tür
list[str]
Açıklama
Açık başvuru kenarı türleri (CALL, IMPORT, READS vb.). Boş olmayan liste reference_views değerini geçersiz kılar.

En İyi Kullanım:

  • Bilinen bir symbol'ün definition, reference ve graph metric'lerini sabitleme
  • symbol_name verilmediğinde centrality, high_impact veya in_cycle'a göre gözden geçirme

Önerilmeyen Kullanım:

  • Kavramsal veya bilinmeyen alan sorguları — intelligent_search ya da semantic_search kullanın

analyze_dependencies Kararlı

dependency_search ile aynı dolaşımı kullanarak etki yarıçapını analiz eder (dependents/incoming). Etki analizi için analysis_type="dependents" veya "impact" ile dependency_search tercih edin. graph, connection_summary ve refactor_risk içeren isteğe bağlı metriklerle çok adımlı etki yanıtı döndürür. İlişki ailesini kapsamak için graph_view kullanın: dependency (varsayılan), type, data_flow, control_flow. connection_summary, seçilen kök için ilişki ailesiyle sınırlı kenarları, test/yol filtrelemesinden önce sayar. Eski incoming_production/outgoing_production alanları, testler dâhil modül dışı kenarları belirtir; üretim çağıranlarının sayısı değildir.

Parametreler:

repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
target Zorunlu
Tür
str minLength=1
Açıklama
Analiz edilecek sembol adı
symbol_id Opsiyonel
Tür
UUID
Açıklama
Ad alanı, yol ve dil filtrelemesinden sonra target adayları arasından UUID ile belirli bir oluşumu seçin; sınırlı aday penceresinin dışındaki ID değerleri hataya yol açar.
depth Opsiyonel
Tür
Literal[shallow, balanced, deep]
Varsayılan
balanced
Açıklama
Analiz derinliği
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
10
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.
direction Opsiyonel
Tür
Literal[incoming, outgoing, both]
Varsayılan
incoming
Açıklama
Dolaşım yönü
relationship_types Opsiyonel
Tür
list[str]
Açıklama
Kenar türlerine göre filtreler (CALL, IMPORT, INHERITS_FROM vb.). Boş olmayan bir liste graph_view varsayılanlarını geçersiz kılar; boş liste bu varsayılanları kullanır.
graph_view Opsiyonel
Tür
Literal[dependency, type, data_flow, control_flow]
Varsayılan
dependency
Açıklama
Graf görünümü: hem varsayılan olarak dolaşılan kenar türlerini hem de include_metrics=true olduğunda hangi görünümün metriklerinin kullanılacağını belirler. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (varsayılan), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. relationship_types atlandığında veya boş olduğunda bu, relationship_types varsayılanı olarak uygulanır. Araçlar arasında tutarlılık için dependency_search'ün mevcut graph_view parametre adıyla eşleşir.
path_filter Opsiyonel
Tür
str
Açıklama
Target symbol çözümlemesini file path prefix'ine göre kısıtlar; döndürülen graph ilişkileri bu path'in dışına çıkabilir
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
per_hop_limit Opsiyonel
Tür
int minimum=1, maximum=300
Açıklama
Hop başına maksimum ilişki sayısı (1-300)
include_metrics Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Her biri türetilmiş bir refactor_risk bloğu ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}) ile zenginleştirilmiş graf ölçümlerini sonuçlara ekleyin. risk, bir eklem noktası olmadığında (seçili görünümde) "low"'dir, birkaç kenarı köprüleyen bir eklem noktası olduğunda "medium", birçok kenarı köprülediğinde "high"'dir (buluşsal eşik, ampirik olarak doğrulanmamıştır). Söz konusu sembol/görünüm için hiçbir ölçüm satırı bulunmadığında, sembol başına atlanır.
metrics_detail Opsiyonel
Tür
Literal[summary, full]
Varsayılan
summary
Açıklama
include_metrics=true olduğunda: summary (varsayılan), karar sinyallerini ve refactor_risk değerini döndürür; full, seçilmiş metriklerin daha geniş kümesini döndürür
include_edge_metadata Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Ham kenar meta verilerini ve ağırlıklarını ekleyin. Çıkarıcı meta verileri büyük olabileceğinden varsayılan olarak devre dışıdır; zenginleştirme kapsamı etkinleştirildiğinde raporlanır.
exclude_test_paths Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Varsayılan true: döndürülen graf kenarlarından test, fixture, üçüncü taraf kodu ve örnek yollarını hariç tutar. Bunları dahil etmek için false ayarlayın.
include_module_symbols Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Varsayılan false: from_name veya to_name değeri sentetik __module__ sembolü olan kenarlar (modül düzeyindeki gürültü) hariç tutulur. Modül düzeyindeki kenarları dahil etmek için true olarak ayarlayın.
head_commit Opsiyonel
Tür
str pattern=^[0-9a-fA-F]{7,64}$
Açıklama
Sorduğunuz kodun commit SHA'sı (git rev-parse HEAD veya patch'in temel commit'i). complete:true için dizinin bu commit'te olması ve güncel resolver ile oluşturulmuş olması gerekir; aksi halde index_stale / index_freshness_unverified / index_built_by_older_resolver ile complete:false olarak kalır ve index_basis.statement yanıtın hangi kapsamda eksiksiz olduğunu belirtir. Bir patch'in 'base-commit:' satırı (git format-patch --base) da bu değeri sağlar.

En İyi Kullanım:

  • graph ve connection_summary yanıt alanları gerektiğinde çok adımlı etki analizi

Önerilmeyen Kullanım:

  • Genel etki analizi — esnek dolaşım ve birden çok başlangıç noktası kontrolü için dependency_search tercih edin

get_task_context Kararlı

Yabancı bir alanda çalışmaya mı başlıyorsunuz? Görevi tanımlayın (örneğin "SSO desteği ekle", "faturalandırma webhook'unu düzelt") ve ilgili dosyaların, kodun, symbol'lerin ve bağımlılıkların sınırlı bir paketini tek bir çağrıda alın. Seed olarak verilen dosyalar, hiçbir symbol tanımlamasalar bile doğrudan dizinlenmiş içerik sağlar. Başarısız katmanlar etiketlenir; toplam alma başarısızlığında bir araç hatası döndürülür. Daha fazla sonuç için, o katmana özel arama aracıyla devam edin.

Parametreler:

task_description Zorunlu
Tür
str minLength=1
Açıklama
Bağlam istediğiniz görev açıklaması
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
15
Açıklama
Katman başına maksimum sonuç
scope Opsiyonel
Tür
Literal[semantic, symbols, dependencies, all]
Varsayılan
all
Açıklama
Hangi bağlam katmanlarının dahil edileceği
language_filter Opsiyonel
Tür
str
Açıklama
Dil filtresi: açık başlangıç noktaları veya ilgili bağlam olmadan scope=semantic gerektirir; diğer katman dizinleri dili zorunlu kılamaz.
path_filter Opsiyonel
Tür
str
Açıklama
Anlamsal ve anahtar sözcük tabanlı getirme başlangıç noktaları için dosya yolu öneki. Açık başlangıç noktaları bu önekin dışında olabilir; graph bağlamı dizin sınırlarını aşabilir.
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
include_related_context Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Bitişik sembollerden ilgili bağlamı dahil et
seed_symbol_ids Opsiyonel
Tür
list[str] maxItems=20
Açıklama
Açık görev başlangıç noktaları: sembol katmanında ilk sırada yer alır ve sınırlı dependencies/related_context penceresi içinde tutulur. Graph katmanları, anahtar sözcüğe geri dönmeden önce açık başlangıç noktalarını ve onların en yakın komşuluğunu sıralar; önem yalnızca ilgililik eşit olduğunda belirleyicidir. Graph genişletme scope=all|dependencies gerektirir (scope=symbols|semantic bağımlılık traversal'ını hiçbir zaman çalıştırmaz). Yalnızca anahtar sözcüğe dayalı, derinliğe göre azalan önem sıralaması için bu parametreyi belirtmeyin.
seed_file_paths Opsiyonel
Tür
list[str] maxItems=10
Açıklama
Açık başlangıç noktaları: agent'ın açık olan veya az önce düzenlediği tam eşleşen indexed dosya path'leri. Sınırlı doğrudan dosya kanıtı ve dosya başına en fazla 5 graph başlangıç noktası döndürür; sınırlı symbol aramasından gelen tam görev adı eşleşmelerini, tanımların ve rastlantısal sembollerin önüne alır. Symbol içermeyen dosyalar da kanıt sağlar. Eksik dosyalar, başlangıç noktası olmayan etiketli öneriler döndürebilir. Graph genişletme scope=all|dependencies gerektirir.

En İyi Kullanım:

  • Seed edilen dosyaları semantic, symbol ve dependency katmanlarıyla harmanlayan task-aware context

Önerilmeyen Kullanım:

  • Daha spesifik bir tool'un soruyu zaten yanıtladığı single-tool aramaları

get_file Kararlı

Yola göre dizinlenmiş repodan bir dosya okur. Diskteki dosyalar için yerel dosya araçlarını tercih edin; bunu uzak dizinlenmiş anlık görüntüler için kullanın. Sınırlı yanıtları metadata.next_line_start ve next_character_start ile sürdürün. Sondaki satır sonu ile [truncated] işaretini yalnızca metadata.truncated=true olduğunda kaldırın; aksi halde bu, gerçek kaynak metni olabilir.

Parametreler:

file_path Zorunlu
Tür
str
Açıklama
Repo köküne göre dosya yolu
repository Opsiyonel
Tür
str
Açıklama
Repo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir repoya erişebiliyorsa belirtmeyin; farklı bir dizinlenmiş repoyu hedeflemek için yalnızca açıkça iletin. Tam eşleşen dizinlenmiş dallar tercih edilir; kullanılamayan bir dal main'e veya erişilebilen tek dala geri düşebilir. Yanıt meta verileri istenen ve çözümlenen kimliği gösterir ve bu geri düşme durumunda uyarır.
line_start Opsiyonel
Tür
int minimum=1
Açıklama
Başlangıç satırı (1-index)
line_end Opsiyonel
Tür
int minimum=1
Açıklama
Bitiş satırı (1-indexed, dahil; line_start'a eşit veya sonrasında olmalı)
character_start Opsiyonel
Tür
int minimum=0
Varsayılan
0
Açıklama
Yalnızca başlangıç satırı içinde UTF-16 kod birimi cinsinden ofset (0 tabanlı). Kısmen okunan satıra devam etmek için metadata.next_character_start kullanın.
branch Opsiyonel
Tür
str
Açıklama
Dal geçersiz kılma
max_tokens Opsiyonel
Tür
int minimum=1, maximum=50000
Varsayılan
5000
Açıklama
Yaklaşık içerik bütçesi (token başına 4 UTF-16 kod birimi; kesin bir tokenizer sınırı değildir).
include_metadata Opsiyonel
Tür
bool
Varsayılan
true
Açıklama
Açıklayıcı dosya meta verilerini dahil eder. Kesilme ve devam meta verileri her zaman döndürülür.

En İyi Kullanım:

  • Remote veya indexed dosya snapshot'ları (line range, token limit)

Önerilmeyen Kullanım:

  • Zaten yerel diskte olan bir path — yerel Read tool'unu kullanın

Sistem ve Yardımcı Araçlar

#

repository_context Kararlı

Arayabileceğiniz repository'leri listeler veya birinin kimlik bilgilerini alır (namespace/branch, indexed_commit_sha / dizin güncelliği). Repository slug'ı bilinmiyorsa action:"list" kullanın; arama araçları bilinen bir slug'ı doğrudan kabul eder veya varsayılan olarak anahtarınıza ait tek repository'yi kullanır. list, pattern ve sayfalama kullanır; info için repository gereklidir ve branch ile isteğe bağlı include_statistics=true desteklenir.

Parametreler:

action Zorunlu
Tür
Literal[list, info]
Açıklama
İşlem: erişilebilir repoları listele veya repo bilgisi al
repository Opsiyonel
Tür
str
Açıklama
Yalnızca info için: owner/repo veya owner/repo:branch biçiminde repository (info için zorunludur)
branch Opsiyonel
Tür
str
Açıklama
Yalnızca info için: dal geçersiz kılma
pattern Opsiyonel
Tür
str
Açıklama
Yalnızca list için: büyük/küçük harfe duyarsız repository adı alt dizesi
include_statistics Opsiyonel
Tür
bool
Varsayılan
false
Açıklama
Yalnızca bilgi amaçlı: sınırlı dizin veri sayımlarını içerir. file/blob sayımları kesindir; daha büyük dizin sayımları tahminidir. count_accuracy ve estimate_analyzed_at'e bakın. Varsayılan false.
limit Opsiyonel
Tür
int minimum=1, maximum=50
Varsayılan
20
Açıklama
cursor kullanılmadığında sayfa başına maksimum sonuç sayısı. Devam eden istekler cursor içinde saklanan sayfa boyutunu kullanır; farklı bir limit ile başlamak için cursor'u atlayın.
offset Opsiyonel
Tür
int minimum=0
Açıklama
Geriye dönük uyumluluk için tutulan, kullanımdan kaldırılmış ofset. pagination.next_cursor içindeki cursor değerini tercih edin.
cursor Opsiyonel
Tür
str
Açıklama
pagination.next_cursor'dan gelen opak cursor. Değiştirmeden iletin ve query ile filtreleri değiştirmeyin. Konumu ve sayfa boyutu offset ve limit'ten önceliklidir.

En İyi Kullanım:

  • Erişilebilir repository'leri listeleme
  • Repository identity, branch ve HEAD-vs-index freshness'ı çözümleme

Önerilmeyen Kullanım:

  • Varsayılan olarak namespace genelindeki istatistikler — resolution'dan daha yavaş olabileceği için include_statistics=true'yu açıkça geçirin

ask_maguyva Kararlı

Maguyva araç rehberliği alın veya Maguyva bakım ekibi için saklanan bir hata raporu ya da özellik isteği gönderin. Geri bildirime asla sırları veya hassas kişisel verileri eklemeyin. evaluate işlemi deterministik ifadeleri destekler; matematik, karma ve dize işleri için yerel hesaplamayı veya ana ortamın araçlarını tercih edin.

Parametreler:

operation Zorunlu
Tür
Literal[guidance, report_bug, request_feature, evaluate]
Açıklama
Araç yardımı için guidance, hatalar için report_bug, öneriler için request_feature kullanın. evaluate deterministik ifadeleri yürütür; hesaplamalarda yerel araçları tercih edin.
query Opsiyonel
Tür
str maxLength=500
Açıklama
Rehberlik konusu (ör. tool_selection, semantic_search) veya evaluate için ifade dizesi.
description Opsiyonel
Tür
str minLength=1, maxLength=4000
Açıklama
report_bug ve request_feature için gerekli. Maguyva'nın maintainer'ları için Free-form geri bildirim. Asla secret veya hassas kişisel veri paylaşmayın.
related_tool Opsiyonel
Tür
Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]
Açıklama
Geri bildirimle en yakından ilişkili isteğe bağlı Maguyva aracı

En İyi Kullanım:

  • Tool guidance (operation="guidance")
  • Maguyva'nın maintainer'ları için kalıcı bug report ve feature request'ler

Önerilmeyen Kullanım:

  • Matematik, karma ve dize hesaplama — yerel hesaplamayı veya ana ortamın araçlarını tercih edin

En İyi Uygulamalar

#
  1. Açık Geçersiz Kılmaları Bilinçli Kullanın: MCP istemciniz bir istek varsayılanı sağladığında veya anahtar tam olarak bir repoya erişebildiğinde repoyu atlayın; aksi halde açıkça iletin.
  2. Doğru Arama Modunu Seçin: Çoğu durumda mode="auto" ile intelligent_search kullanın. Tam olarak neye ihtiyacınız olduğunu bildiğinizde bir mod belirtin.
  3. Dil Filtrelerinden Yararlanın: language_filter ile sonuçları daraltın ve performansı artırın.
  4. GraphRAG Güçlendirme: Anlamsal arama için GraphRAG önem güçlendirmesi, sıralamayı ajan açısından güvenli tutmak amacıyla varsayılan olarak kapalıdır (boost_by_importance=false). Mimari turlar için merkeziyet-duyarlı yeniden sıralamayı etkinleştirmek üzere boost_by_importance=true iletin.
  5. Repo Eşleştirme Büyük/Küçük Harfe Duyarsızdır, Bulanık Değildir: repository_context, repo adlarını büyük/küçük harf ayrımı gözetmeden eşleştirir; yazım hatalarını düzeltmez. Sunulan kimlik istenenden farklıysa metadata.resolution_reason, "defaulted" (bir dal istenmedi) ya da "fallback" (istenen dal veya repo kullanılamıyor) değerini bildirir. İstek tam olarak eşleştiğinde bu alan yer almaz.
  6. Araçları Birleştirin: Kapsamlı analiz için birden çok API yöntemini birlikte kullanın.
  7. Büyük Sonuçları Yönetin: limit ve araca özgü sayfalama denetimlerini kullanın (örneğin get_file içinde line_start/line_end).
  8. Araç Rehberliği için ask_maguyva Kullanın: Araç seçimi önerileri ve örnekleri için ask_maguyva aracını operation="guidance" ve query="tool_selection" ile çağırın. Hesaplamalar ve dize dönüşümleri için yerel araçlarınızı kullanın.
  9. Düzenlemeden Önce ve Sonra Etkiyi Doğrulayın: Paylaşılan bir sembolü düzenlemeden önce, etki yarıçapını (blast radius) görmek için analysis_type="impact" ile dependency_search çağırın (veya PR/diff etkisi için changed_paths iletin). Düzenledikten sonra, aynı sembolleri kısa ve öz şekilde yeniden kontrol etmek için targets ve/veya changed_paths ile birlikte verify_after_edit=true ayarlayın. Bu denetim dizine alınmış grafı okur; commit edilmemiş yerel değişiklikleri okumaz ve yerel testlerin yerini almaz. Sonuçları yeni bir revizyon için kanıt saymadan önce indexed_commit_sha değerini ve dizinin güncelliğini kontrol edin.

Performans Özellikleri

#
İşlem Performans notları
Anlamsal arama Sorgunun vektör temsilinin oluşturulmasını ve vektör aramasını içerir. Gecikme her iki işleme de bağlıdır.
Metin arama İçerikte bulanık aramada daha ilerideki sayfalar daha çok aday getirir. Sorguyu path_filter ve language_filter ile daraltın.
Yapısal arama Dizine alınmış AST düğümlerini sorgular. Belirli bir önayar veya örüntü kullanın ve sonuç sayısını sınırlayın.
Bağımlılık araması Maliyet derinliğe göre ölçeklenir — çok sıçramalı bağlama ihtiyacınız yoksa depth="shallow" tercih edin; per_hop_limit yayılımı sınırlar
Dosya alma Gereken aralığı line_start/line_end veya max_tokens ile okuyun; kesilen içerik için döndürülen devam meta verisini kullanın.
Repo bağlamı Repo çözümlemesi her araç çağrısında çalışır. Belirli bir repo gerektiğinde repository parametresini açıkça geçirin.
ask_maguyva (guidance / evaluate) Repo dizinini sorgulamadan MCP sunucusunda çalışır.

Hata Yönetimi

#

Araç yanıtları en üst düzeyde ortak durum alanları ve araca özgü yük alanları içerir. Aramalar results, get_file ise content döndürür. Ortak alanlar şunlardır:

  • status: Dize — "success" veya "error". Zayıflamış eşleşme ve tazelik sinyallerinin kendi alanları vardır: metadata altındaki metadata.resolution_reason ve repository_context info eyleminin en üst düzeyindeki index_freshness.status.
  • timing_ms: Aracın milisaniye cinsinden yürütme süresi
  • applied_filters: İşlem için kaydedilen, fiilen uygulanan istek parametreleri
  • error: status, "error" olduğunda hata mesajı dizesi; kurtarma yönlendirmeleri içerebilir.
  • metadata: İşlem hakkında ek bilgi (yönlendirme, önbellekleme, parametre ayarlamaları)
  • pagination: İmleçle sayfalanan koleksiyon yanıtlarında bulunur; has_more ve next_cursor içerir. Sıralı arama pencereleri sınırlı top-K sonuçlarıdır, eksiksiz sayfalanmış koleksiyonlar değildir.

Bir aracın yükünü işlemeden önce status alanını denetleyin; değerleri "success" veya "error" olur. Araç yükü üretilmeden önce ortaya çıkabilen MCP/JSON-RPC taşıma ve istek doğrulama hatalarını da ele alın. Zayıflamış eşleşme veya tazelik sinyalleri için bunlara ayrılmış alanı okuyun: metadata altındaki metadata.resolution_reason ya da repository_context info eyleminin en üst düzeyindeki index_freshness.status (known/partial/unknown/unavailable).

Başlarken

#
  1. MCP İstemcisini Yapılandır: MCP istemcinizi Maguyva sunucu uç noktasına yönlendirin
  2. Repo Erişimini Doğrulayın: API anahtarının erişebildiği repoları görmek için repository_context ile list veya info kullanın
  3. Aramaya Başlayın: Doğal dil sorgusu verip intelligent_search ile başlayın; gerekirse özel araçları keşfedin
  4. Araçları Birleştirin: Kapsamlı kod analizi için araçları birlikte kullanın

Ayrıntılı entegrasyon talimatları için kurulum rehberi sayfasına bakın.

İlgili

Sıradaki okuma