MCP API Referansı

11 müşteriye yönelik Maguyva MCP aracının tamamı için eksiksiz referans. Her araç parametreleri, kullanım rehberliğini ve en iyi kullanım önerilerini içerir.

API Genel Bakış#

Maguyva MCP API'si şu anda 4 ana kategoride 11 müşteriye yönelik araç sunuyor:

Temel Arama Araçları - Kod tabanınız genelinde gelişmiş arama yetenekleri
Yapısal ve Grafik 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ı, deterministik hesaplama ve rehberlik

Tüm araçlar tutarlı bir repo tanımlayıcı biçimi kullanır: "owner/repo:branch". Belirtilmezse branch main olarak varsayılır.

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

Repo Parametresi Biçimi#

Tüm MCP araçları bu repo tanımlayıcı biçimini kullanır:

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 depo: MCP istemcisi istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa repository değerini belirtmeyin; aksi halde açıkça gönderin.

Örnek promptlar:

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

Dil Filtreleme#

Tüm arama araçları, sonuçları programlama diline göre filtrelemeyi destekler:

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 279+ 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ı 22 Temmuz 2026 tarihinde kaynaktan üretildi.

Temel Arama Araçları#

intelligent_searchKararlı

Herhangi bir kod tabanı sorusu için buradan başlayın. Ona doğal dilde bir sorgu verin (örneğin, "kimlik doğrulama nasıl çalışır", "faturalandırma nerede işlenir") ve indekslenmiş deponun anlamsal, sembol, yapısal ve bağımlılık araması boyunca otomatik olarak yönlendirir. Keşif ve planlama için Explore aracısı ve Grep/Glob yerine bunu tercih edin; dosyaları taramak yerine dizine alınmış deponun tamamını tek seferde arar.

Parametreler:

queryZorunlu

Tür: str
Açıklama: Arama sorgusu

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

modeOpsiyonel

Tür: Literal[auto, hybrid, semantic, text, structural, ast, graph]
Varsayılan: auto
Açıklama: Arama modu

limitOpsiyonel

Tür: int
Varsayılan: 10
Açıklama: Bu sıralı top-K penceresindeki maksimum sonuç sayısı

language_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

boost_by_importanceOpsiyonel

Tür: bool
Varsayılan
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.

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

qualityOpsiyonel

Tür: Literal[quick, balanced, thorough]
Varsayılan: balanced
Açıklama: Arama kalite ön ayarı

include_contentOpsiyonel

Tür: bool
Varsayılan: true
Açıklama: Sonuçlara içeriği dahil et

explain_routingOpsiyonel

Tür: bool
Varsayılan
Açıklama: Yönlendirme kararı açıklamasını dahil et

importance_weightOpsiyonel

Tür: float
Varsayılan: 0.3
Açıklama: Önem güçlendirmesi ağırlığı (0=yok, 1=tam)

orphansOpsiyonel

Tür: bool
Varsayılan
Açıklama: Öksüz sembolleri dahil et (gelen referans yok)

include_community_contextOpsiyonel

Tür: bool
Varsayılan
Açıklama: Aynı kod topluluğundan ilgili sembolleri dahil et

community_depthOpsiyonel

Tür: int
Varsayılan: 1
Açıklama: Topluluk bağlamı genişletme derinliği

graph_viewOpsiyonel

Tür: Literal[dependency, type, data_flow, control_flow]
Varsayılan: dependency
Açıklama: Metrikler için grafik görünümü

seed_symbol_idsOpsiyonel

Tür: list[str]
Açıklama: Tier-1 görev tohumları: mevcut görevin merkezinde yer alan sembol kimlikleri. Ayarlandığında, birleştirilmiş isabetleri Approach A derinlik azalması yakınlığına göre yeniden sıralar (tam tohum eşleşmesi + grafik kenarı atlamaları). Katkı maddesi - küresel sıralama için atlayın.

seed_file_pathsOpsiyonel

Tür: list[str]
Açıklama: Tier-1 görev tohumları: aracının açtığı veya henüz düzenlediği dizinli dosya yolları. Ayarlandığında, 1/(1+d) derinlik azalmasıyla (aynı dosya → aynı dizin → yakındaki paketler) birleştirilmiş isabetleri yol yakınlığına göre yeniden sıralar. Katkı maddesi - küresel sıralama için atlayın.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`query`	`str`	Evet	-	Arama sorgusu
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`mode`	`Literal[auto, hybrid, semantic, text, structural, ast, graph]`	Hayır	`auto`	Arama modu
`limit`	`int`	Hayır	`10`	Bu sıralı top-K penceresindeki maksimum sonuç sayısı
`language_filter`	`str`	Hayır	-	Dil filtresi
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`boost_by_importance`	`bool`	Hayır		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`	`str`	Hayır	-	Dal geçersiz kılma
`quality`	`Literal[quick, balanced, thorough]`	Hayır	`balanced`	Arama kalite ön ayarı
`include_content`	`bool`	Hayır	`true`	Sonuçlara içeriği dahil et
`explain_routing`	`bool`	Hayır		Yönlendirme kararı açıklamasını dahil et
`importance_weight`	`float`	Hayır	`0.3`	Önem güçlendirmesi ağırlığı (0=yok, 1=tam)
`orphans`	`bool`	Hayır		Öksüz sembolleri dahil et (gelen referans yok)
`include_community_context`	`bool`	Hayır		Aynı kod topluluğundan ilgili sembolleri dahil et
`community_depth`	`int`	Hayır	`1`	Topluluk bağlamı genişletme derinliği
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Hayır	`dependency`	Metrikler için grafik görünümü
`seed_symbol_ids`	`list[str]`	Hayır	-	Tier-1 görev tohumları: mevcut görevin merkezinde yer alan sembol kimlikleri. Ayarlandığında, birleştirilmiş isabetleri Approach A derinlik azalması yakınlığına göre yeniden sıralar (tam tohum eşleşmesi + grafik kenarı atlamaları). Katkı maddesi - küresel sıralama için atlayın.
`seed_file_paths`	`list[str]`	Hayır	-	Tier-1 görev tohumları: aracının açtığı veya henüz düzenlediği dizinli dosya yolları. Ayarlandığında, 1/(1+d) derinlik azalmasıyla (aynı dosya → aynı dizin → yakındaki paketler) birleştirilmiş isabetleri yol yakınlığına göre yeniden sıralar. Katkı maddesi - küresel sıralama için atlayın.

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_searchKararlı

Kodu tam metne göre değil, anlama göre bulun. Anahtar kelimeyi veya sembol adını bilmediğinizde "yeniden deneme mantığı" veya "kullanıcı katılım akışı" gibi kavramsal sorgular için kullanın. Önem sırasına göre en alakalı kod parçalarını döndürür. Arama kavramsal olduğunda Grep'i tercih edin.

Parametreler:

queryZorunlu

Tür: str
Açıklama: Arama sorgusu (kavramsal, anlama dayalı)

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

limitOpsiyonel

Tür: int
Varsayılan: 5
Açıklama: Bu sıralı top-K penceresindeki maksimum sonuç sayısı

similarity_thresholdOpsiyonel

Tür: float
Varsayılan: 0.6
Açıklama: Minimum benzerlik skoru

language_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi (python, typescript, vb.)

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

boost_by_importanceOpsiyonel

Tür: bool
Varsayılan
Açıklama: Opsiyonel: PageRank centrality'ye göre yeniden sırala (agent-safe sıralama için varsayılan olarak kapalı; mimari turlar için etkinleştirin)

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma (varsayılan: repository parametresinden veya main)

include_contentOpsiyonel

Tür: bool
Varsayılan: true
Açıklama: Parça içeriğini sonuçlara dahil et

graph_viewOpsiyonel

Tür: Literal[dependency, type, data_flow, control_flow]
Varsayılan: dependency
Açıklama: Metrikler için graph view

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`query`	`str`	Evet	-	Arama sorgusu (kavramsal, anlama dayalı)
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`limit`	`int`	Hayır	`5`	Bu sıralı top-K penceresindeki maksimum sonuç sayısı
`similarity_threshold`	`float`	Hayır	`0.6`	Minimum benzerlik skoru
`language_filter`	`str`	Hayır	-	Dil filtresi (python, typescript, vb.)
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`boost_by_importance`	`bool`	Hayır		Opsiyonel: PageRank centrality'ye göre yeniden sırala (agent-safe sıralama için varsayılan olarak kapalı; mimari turlar için etkinleştirin)
`branch`	`str`	Hayır	-	Dal geçersiz kılma (varsayılan: repository parametresinden veya main)
`include_content`	`bool`	Hayır	`true`	Parça içeriğini sonuçlara dahil et
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Hayır	`dependency`	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_searchKararlı

İndekslenmiş içeriği arayın. Exact ve regex modları tüm dosya/blob kümesini tarar; fuzzy içerik modu sınırlı anlamsal parça kümesini arar. Dosya ve sembol kapsamları yalnızca fuzzy moddadır. Yerel diskteki dar bir dizin için yerel Grep tercih edin.

Parametreler:

queryZorunlu

Tür: str
Açıklama: Aranacak metin kalıbı

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

modeOpsiyonel

Tür: Literal[fuzzy, exact, regex]
Varsayılan: exact
Açıklama: Arama modu

search_scopeOpsiyonel

Tür: Literal[content, symbols, files]
Varsayılan: content
Açıklama: Ne aranacak

limitOpsiyonel

Tür: int
Varsayılan: 5
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.

language_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

case_sensitiveOpsiyonel

Tür: bool
Varsayılan
Açıklama: Büyük/küçük harfe duyarlı eşleşme

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

fuzzy_algorithmOpsiyonel

Tür: Literal[hybrid, trigram, levenshtein]
Varsayılan: hybrid
Açıklama: Bulanık eşleşme algoritması

thresholdOpsiyonel

Tür: float
Varsayılan: 0.05
Açıklama: Bulanık için minimum benzerlik eşiği

semantic_fallbackOpsiyonel

Tür: bool
Varsayılan
Açıklama: Sonuç yoksa anlamsal aramaya düş

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`query`	`str`	Evet	-	Aranacak metin kalıbı
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`mode`	`Literal[fuzzy, exact, regex]`	Hayır	`exact`	Arama modu
`search_scope`	`Literal[content, symbols, files]`	Hayır	`content`	Ne aranacak
`limit`	`int`	Hayır	`5`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.
`language_filter`	`str`	Hayır	-	Dil filtresi
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`case_sensitive`	`bool`	Hayır		Büyük/küçük harfe duyarlı eşleşme
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`fuzzy_algorithm`	`Literal[hybrid, trigram, levenshtein]`	Hayır	`hybrid`	Bulanık eşleşme algoritması
`threshold`	`float`	Hayır	`0.05`	Bulanık için minimum benzerlik eşiği
`semantic_fallback`	`bool`	Hayır		Sonuç yoksa anlamsal aramaya düş

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_searchKararlı

preset=functions|classes|methods|imports|variables kullanmayı tercih edin (ya da serbest pattern=). Kodu metne göre değil AST şekline göre bulun. Orta seviye filtreler: name_pattern, node_type, decorator, parent_child. Path/ltree/call filtreleri gelişmiştir — bunları bilinçli olarak kullanırken advanced=true ayarlayın; geriye dönük uyumluluk için düz advanced anahtarları hâlâ kabul edilir. En az bir structural selector sağlayın.

Parametreler:

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

presetOpsiyonel

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/impl tanımları); 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.

patternOpsiyonel

Tür: str
Açıklama: Preset'ler çok kaba kaldığında Free-form pattern (otomatik algılanır: 'def foo(' → node_type + name_pattern). Browse sorguları için preset= tercih edin.

name_patternOpsiyonel

Tür: str
Açıklama: Symbol adı pattern'i (shell wildcard, sınırlı POSIX regex veya fuzzy metin; en fazla 256 karakter)

node_typeOpsiyonel

Tür: str
Açıklama: AST node türü (function_definition, class_definition, vb.) — yaygın şekiller için preset= tercih edin

decoratorOpsiyonel

Tür: str
Açıklama: Dekoratör adı filtresi

base_classOpsiyonel

Tür: str
Açıklama: Temel sınıf filtresi

language_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi (python, typescript, vb.)

limitOpsiyonel

Tür: int
Varsayılan: 20
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

query_typeOpsiyonel

Tür: Literal[node_type, name_pattern, parent_child]
Açıklama: Açık sorgu türü

parent_typeOpsiyonel

Tür: str
Açıklama: Üst AST düğüm türü filtresi

relationshipOpsiyonel

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_modifierOpsiyonel

Tür: str
Açıklama: Modifier ile filtrele (export, async, static, vb.)

advancedOpsiyonel

Tür: bool
Varsayılan
Açıklama: Gelişmiş yol, ağaç veya çağrı filtrelerini (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name) kasıtlı olarak kullanırken true'yi ayarlayın. Varsayılan olarak false, aracı arayüzünün ön ayarlara odaklanmasını sağlar. Düz formattaki gelişmiş anahtarlar, meta veri uyarısıyla birlikte geriye dönük uyumluluk için çalışmaya devam ediyor.

callee_textOpsiyonel

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_nameOpsiyonel

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_roleOpsiyonel

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_ancestorOpsiyonel

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_descendantOpsiyonel

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_nameOpsiyonel

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_depthOpsiyonel

Tür: int
Açıklama: Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Minimum AST depth. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.

max_depthOpsiyonel

Tür: int
Açıklama: Gelişmiş — preset=functions|classes|methods|imports|variables tercih edin. Maximum AST depth. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`preset`	`Literal[functions, classes, methods, imports, variables]`	Hayır	-	Tercih edilen structural selector. Diller arası AST node türlerine genişler — functions (dillerdeki function/arrow/method tanımları); classes (class/struct/impl tanımları); 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`	`str`	Hayır	-	Preset'ler çok kaba kaldığında Free-form pattern (otomatik algılanır: 'def foo(' → node_type + name_pattern). Browse sorguları için preset= tercih edin.
`name_pattern`	`str`	Hayır	-	Symbol adı pattern'i (shell wildcard, sınırlı POSIX regex veya fuzzy metin; en fazla 256 karakter)
`node_type`	`str`	Hayır	-	AST node türü (function_definition, class_definition, vb.) — yaygın şekiller için preset= tercih edin
`decorator`	`str`	Hayır	-	Dekoratör adı filtresi
`base_class`	`str`	Hayır	-	Temel sınıf filtresi
`language_filter`	`str`	Hayır	-	Dil filtresi (python, typescript, vb.)
`limit`	`int`	Hayır	`20`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`query_type`	`Literal[node_type, name_pattern, parent_child]`	Hayır	-	Açık sorgu türü
`parent_type`	`str`	Hayır	-	Üst AST düğüm türü filtresi
`relationship`	`Literal[parent, ancestor]`	Hayır	`parent`	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`	`str`	Hayır	-	Modifier ile filtrele (export, async, static, vb.)
`advanced`	`bool`	Hayır		Gelişmiş yol, ağaç veya çağrı filtrelerini (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name) kasıtlı olarak kullanırken true'yi ayarlayın. Varsayılan olarak false, aracı arayüzünün ön ayarlara odaklanmasını sağlar. Düz formattaki gelişmiş anahtarlar, meta veri uyarısıyla birlikte geriye dönük uyumluluk için çalışmaya devam ediyor.
`callee_text`	`str`	Hayır	-	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`	`str`	Hayır	-	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`	`str`	Hayır	-	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`	`str`	Hayır	-	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`	`str`	Hayır	-	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`	`str`	Hayır	-	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`	`int`	Hayır	-	Gelişmiş — preset=functions\|classes\|methods\|imports\|variables tercih edin. Minimum AST depth. Path/ltree/call filtrelerini bilinçli olarak kullanırken advanced=true ayarlayın.
`max_depth`	`int`	Hayır	-	Gelişmiş — preset=functions\|classes\|methods\|imports\|variables tercih edin. Maximum AST depth. Path/ltree/call 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_searchKararlı

Birincil etki yarıçapı / graph yüzeyi. Gerçek call/import graph'ı üzerinden "bunu ne çağırıyor?" / "bunu ne 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 (P1-8): 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, impact yolu için ince bir alias'tır — yeni agent'lar için bu aracı tercih edin.

Parametreler:

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

queryOpsiyonel

Tür: str
Açıklama: Sembol adı veya arama terimi

targetOpsiyonel

Tür: str
Açıklama: Sembol adı (query için takma ad)

changed_pathsOpsiyonel

Tür: list[str]
Açıklama: PR/diff etkisi için repo ile ilgili yollar (varsayılan) veya verify_after_edit=true ile düzenleme sonrası doğrulama kökleri. PR/diff: yol başına simgeleri çözer ve sığ gelen bağımlılara yürür; patch= ile birleştirilebilir. Doğrula: doğrulama kökleri olarak yol başına en fazla 5 simgeyi çözümler (doğrulama modunda alt sınırla kapatılmıştır). PR/diff etkisi için query/target gerektirmez.

patchOpsiyonel

Tür: str
Açıklama: PR/diff etkisi: birleşik fark / git yama metni. Yollar diff --git / --- / +++ başlıklarından ayrıştırılır; changed_paths ile aynı kompakt darbe yolu.

analysis_typeOpsiyonel

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.

depthOpsiyonel

Tür: Literal[shallow, balanced, deep]
Varsayılan: balanced
Açıklama: Traversal depth'i. analysis_type=impact ve PR/diff impact için, depth'i açıkça ayarlamadığınız sürece etkin varsayılan shallow'dur.

limitOpsiyonel

Tür: int
Varsayılan: 20
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.

path_filterOpsiyonel

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_filterOpsiyonel

Tür: str
Açıklama: Target çözümlemesini ve browse sonuçlarını dile göre filtrele

directionOpsiyonel

Tür: Literal[outgoing, incoming, both]
Açıklama: Dolaşım yönü (analysis_type çıkarımını geçersiz kılar)

relationship_typesOpsiyonel

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_pathsOpsiyonel

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 her zaman kendi daha katı noise dışlamalarını uygular.

exclude_generated_pathsOpsiyonel

Tür: bool
Varsayılan
Açıklama: Oluşturulan bildirimlerin yanı sıra yapı, kapsam, önbellek, kaynak haritası ve küçültülmüş yapıt yollarını geçiş sonuçlarından hariç tutun

include_module_symbolsOpsiyonel

Tür: bool
Varsayılan
Açıklama: from_name veya to_name sentetik __module__ sembolü (modül düzeyinde gürültü) olduğunda, varsayılan olarak false grafik kenarlarını hariç tutar. true'yi, bağımlı ve bağımlılık ilişkilerine yönelik sonuçlara modül düzeyinde kenarları dahil edecek şekilde ayarlayın.

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

per_hop_limitOpsiyonel

Tür: int
Açıklama: Hop başına maksimum ilişki sayısı (1-300)

include_metricsOpsiyonel

Tür: bool
Varsayılan
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_detailOpsiyonel

Tür: Literal[summary, full]
Varsayılan: summary
Açıklama: include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür

include_edge_metadataOpsiyonel

Tür: bool
Varsayılan
Açıklama: Ham kenar meta verilerini ve ağırlıklarını (büyük) ekleyin. Kompakt darbe yükleri bunu ortadan kaldırır.

symbol_typesOpsiyonel

Tür: list[str]
Açıklama: Döndürülen symbol'leri türe göre filtrele (function, class, method, vb.)

exact_matchOpsiyonel

Tür: bool
Varsayılan
Açıklama: Birebir sembol adı eşleşmesi gerektir (büyük/küçük harf duyarsız)

find_similar_patternsOpsiyonel

Tür: bool
Varsayılan
Açıklama: Benzer kullanım kalıplarını bul

min_centralityOpsiyonel

Tür: float
Varsayılan: 0
Açıklama: Minimum PageRank skoru. Metrikler filtreleme için dahili olarak alınır; graph_metrics yalnızca include_metrics=true olduğunda döndürülür.

graph_viewOpsiyonel

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_editOpsiyonel

Tür: bool
Varsayılan
Açıklama: P2-7 düzenleme sonrası doğrulama modu: yakın zamanda düzenlenen semboller için indekslenmiş etki grafiğini tek bir kompakt çok köklü yanıtta yeniden sorgulayın. targets ve/veya changed_paths (veya target/query) gerektirir. Sığ gelen bakmakla yükümlü oldukları kişiler için varsayılanlar; sonuçlar indekslenmiş grafiği yansıtır (canlı düzenlemelerde gecikme olabilir). Doğru olduğunda, aynı changed_paths üzerindeki PR/diff etkisine göre önceliklidir.

targetsOpsiyonel

Tür: list[str]
Açıklama: verify_after_edit=true olduğunda: yeniden doğrulanacak sembol adları (arayanlar/bağımlı kişiler). Her ikisi de sağlanırsa target/query ile birleştirilir.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`query`	`str`	Hayır	-	Sembol adı veya arama terimi
`target`	`str`	Hayır	-	Sembol adı (query için takma ad)
`changed_paths`	`list[str]`	Hayır	-	PR/diff etkisi için repo ile ilgili yollar (varsayılan) veya verify_after_edit=true ile düzenleme sonrası doğrulama kökleri. PR/diff: yol başına simgeleri çözer ve sığ gelen bağımlılara yürür; patch= ile birleştirilebilir. Doğrula: doğrulama kökleri olarak yol başına en fazla 5 simgeyi çözümler (doğrulama modunda alt sınırla kapatılmıştır). PR/diff etkisi için query/target gerektirmez.
`patch`	`str`	Hayır	-	PR/diff etkisi: birleşik fark / git yama metni. Yollar diff --git / --- / +++ başlıklarından ayrıştırılır; changed_paths ile aynı kompakt darbe yolu.
`analysis_type`	`Literal[centrality, dependencies, dependents, impact, orphans]`	Hayır	`dependencies`	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.
`depth`	`Literal[shallow, balanced, deep]`	Hayır	`balanced`	Traversal depth'i. analysis_type=impact ve PR/diff impact için, depth'i açıkça ayarlamadığınız sürece etkin varsayılan shallow'dur.
`limit`	`int`	Hayır	`20`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.
`path_filter`	`str`	Hayır	-	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`	`str`	Hayır	-	Target çözümlemesini ve browse sonuçlarını dile göre filtrele
`direction`	`Literal[outgoing, incoming, both]`	Hayır	-	Dolaşım yönü (analysis_type çıkarımını geçersiz kılar)
`relationship_types`	`list[str]`	Hayır	-	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`	`bool`	Hayır	`true`	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 her zaman kendi daha katı noise dışlamalarını uygular.
`exclude_generated_paths`	`bool`	Hayır		Oluşturulan bildirimlerin yanı sıra yapı, kapsam, önbellek, kaynak haritası ve küçültülmüş yapıt yollarını geçiş sonuçlarından hariç tutun
`include_module_symbols`	`bool`	Hayır		from_name veya to_name sentetik __module__ sembolü (modül düzeyinde gürültü) olduğunda, varsayılan olarak false grafik kenarlarını hariç tutar. true'yi, bağımlı ve bağımlılık ilişkilerine yönelik sonuçlara modül düzeyinde kenarları dahil edecek şekilde ayarlayın.
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`per_hop_limit`	`int`	Hayır	-	Hop başına maksimum ilişki sayısı (1-300)
`include_metrics`	`bool`	Hayır		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`	`Literal[summary, full]`	Hayır	`summary`	include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür
`include_edge_metadata`	`bool`	Hayır		Ham kenar meta verilerini ve ağırlıklarını (büyük) ekleyin. Kompakt darbe yükleri bunu ortadan kaldırır.
`symbol_types`	`list[str]`	Hayır	-	Döndürülen symbol'leri türe göre filtrele (function, class, method, vb.)
`exact_match`	`bool`	Hayır		Birebir sembol adı eşleşmesi gerektir (büyük/küçük harf duyarsız)
`find_similar_patterns`	`bool`	Hayır		Benzer kullanım kalıplarını bul
`min_centrality`	`float`	Hayır	`0`	Minimum PageRank skoru. Metrikler filtreleme için dahili olarak alınır; graph_metrics yalnızca include_metrics=true olduğunda döndürülür.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Hayır	`dependency`	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`	`bool`	Hayır		P2-7 düzenleme sonrası doğrulama modu: yakın zamanda düzenlenen semboller için indekslenmiş etki grafiğini tek bir kompakt çok köklü yanıtta yeniden sorgulayın. targets ve/veya changed_paths (veya target/query) gerektirir. Sığ gelen bakmakla yükümlü oldukları kişiler için varsayılanlar; sonuçlar indekslenmiş grafiği yansıtır (canlı düzenlemelerde gecikme olabilir). Doğru olduğunda, aynı changed_paths üzerindeki PR/diff etkisine göre önceliklidir.
`targets`	`list[str]`	Hayır	-	verify_after_edit=true olduğunda: yeniden doğrulanacak sembol adları (arayanlar/bağımlı kişiler). Her ikisi 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_symbolKararlı

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 indekslenmiş depoyu kapsar. İsteğe bağlı olarak referanslar ve önem metrikleri döndürebilir.

Parametreler:

symbol_nameOpsiyonel

Tür: str
Açıklama: Aranacak sembol adı (opsiyonel — metriklere göre gezmek için boş bırakın)

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

scopeOpsiyonel

Tür: Literal[definitions, references, both]
Varsayılan: both
Açıklama: Arama kapsamı

limitOpsiyonel

Tür: int
Varsayılan: 15
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.

find_similarOpsiyonel

Tür: bool
Varsayılan
Açıklama: Benzer sembol adlarını dahil et

include_metricsOpsiyonel

Tür: bool
Varsayılan
Açıklama: Merkeziyet metriklerini dahil et

metrics_detailOpsiyonel

Tür: Literal[summary, full]
Varsayılan: summary
Açıklama: include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

symbol_typeOpsiyonel

Tür: Literal[function, class, variable, method, constant, module, interface, type]
Açıklama: Sembol türüne göre filtrele

high_impactOpsiyonel

Tür: bool
Varsayılan
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_modeOpsiyonel

Tür: Literal[popularity, risk]
Varsayılan: popularity
Açıklama: high_impact=true olduğunda: popülerlik = en yüksek PageRank onda birlik kısım eksi faydalı mega hub'lar/modüller; risk = SMV bridge_count ve ardından k_core'ye göre sıralanan eklemlenme noktaları (hub popülerliği değil, yapısal yeniden faktör riski)

in_cycleOpsiyonel

Tür: bool
Varsayılan
Açıklama: Sadece bağımlılık döngülerindeki sembollere filtrele

exclude_test_pathsOpsiyonel

Tür: bool
Varsayılan: true
Açıklama: Grafik 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.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`symbol_name`	`str`	Hayır	-	Aranacak sembol adı (opsiyonel — metriklere göre gezmek için boş bırakın)
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`scope`	`Literal[definitions, references, both]`	Hayır	`both`	Arama kapsamı
`limit`	`int`	Hayır	`15`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.
`find_similar`	`bool`	Hayır		Benzer sembol adlarını dahil et
`include_metrics`	`bool`	Hayır		Merkeziyet metriklerini dahil et
`metrics_detail`	`Literal[summary, full]`	Hayır	`summary`	include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`symbol_type`	`Literal[function, class, variable, method, constant, module, interface, type]`	Hayır	-	Sembol türüne göre filtrele
`high_impact`	`bool`	Hayır		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`	`Literal[popularity, risk]`	Hayır	`popularity`	high_impact=true olduğunda: popülerlik = en yüksek PageRank onda birlik kısım eksi faydalı mega hub'lar/modüller; risk = SMV bridge_count ve ardından k_core'ye göre sıralanan eklemlenme noktaları (hub popülerliği değil, yapısal yeniden faktör riski)
`in_cycle`	`bool`	Hayır		Sadece bağımlılık döngülerindeki sembollere filtrele
`exclude_test_paths`	`bool`	Hayır	`true`	Grafik 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.

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_dependenciesKararlı

dependency_search üzerinden etki yarıçapı için alias (dependents/incoming). Yeni agent'lar için analysis_type="dependents" veya "impact" ile dependency_search'ü tercih edin. Eski multi-hop impact yanıt şeklini korur (graph, connection_summary, opsiyonel metrikler refactor_risk ile). İlişki ailesini kapsamak için graph_view kullanın: dependency (varsayılan), type, data_flow, control_flow.

Parametreler:

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

targetZorunlu

Tür: str
Açıklama: Analiz edilecek sembol adı

depthOpsiyonel

Tür: Literal[shallow, balanced, deep]
Varsayılan: balanced
Açıklama: Analiz derinliği

limitOpsiyonel

Tür: int
Varsayılan: 10
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.

directionOpsiyonel

Tür: Literal[incoming, outgoing, both]
Varsayılan: incoming
Açıklama: Dolaşım yönü

relationship_typesOpsiyonel

Tür: list[str]
Açıklama: Kenar türlerini filtrele (CALL, IMPORT, INHERITS_FROM, vb.). Sağlanırsa graph_view tarafından türetilen varsayılanı her zaman geçersiz kılar.

graph_viewOpsiyonel

Tür: Literal[dependency, type, data_flow, control_flow]
Varsayılan: dependency
Açıklama: Graf görünümü: hem varsayılan dolaşım kenar türlerini belirler hem de include_metrics=true iken hangi görünümün metriklerinin kullanılacağını seçer. 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 açıkça sağlanmadığında varsayılan olarak uygulanır. Araçlar arasında tutarlılık için dependency_search'in mevcut graph_view parametre adıyla eşleşir.

path_filterOpsiyonel

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_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

per_hop_limitOpsiyonel

Tür: int
Açıklama: Hop başına maksimum ilişki sayısı (1-300)

include_metricsOpsiyonel

Tür: bool
Varsayılan
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ş grafik ö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_detailOpsiyonel

Tür: Literal[summary, full]
Varsayılan: summary
Açıklama: include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür

include_edge_metadataOpsiyonel

Tür: bool
Varsayılan
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_pathsOpsiyonel

Tür: bool
Varsayılan: true
Açıklama: Varsayılan true: döndürülen grafik kenarlarından test, fikstür, satıcı ve örnek yolları hariç tutun. false'yi bunları içerecek şekilde ayarlayın.

include_module_symbolsOpsiyonel

Tür: bool
Varsayılan
Açıklama: from_name veya to_name sentetik __module__ sembolü olduğunda, varsayılan olarak false grafik kenarlarını hariç tutar. true'yi modül düzeyinde kenarları içerecek şekilde ayarlayın.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`target`	`str`	Evet	-	Analiz edilecek sembol adı
`depth`	`Literal[shallow, balanced, deep]`	Hayır	`balanced`	Analiz derinliği
`limit`	`int`	Hayır	`10`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılmış uyumluluk offset'i. pagination.next_cursor'dan gelen cursor'u tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'dan gelen opak cursor. Değiştirmeden geçirin ve query ile filtreleri sabit tutun.
`direction`	`Literal[incoming, outgoing, both]`	Hayır	`incoming`	Dolaşım yönü
`relationship_types`	`list[str]`	Hayır	-	Kenar türlerini filtrele (CALL, IMPORT, INHERITS_FROM, vb.). Sağlanırsa graph_view tarafından türetilen varsayılanı her zaman geçersiz kılar.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Hayır	`dependency`	Graf görünümü: hem varsayılan dolaşım kenar türlerini belirler hem de include_metrics=true iken hangi görünümün metriklerinin kullanılacağını seçer. 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 açıkça sağlanmadığında varsayılan olarak uygulanır. Araçlar arasında tutarlılık için dependency_search'in mevcut graph_view parametre adıyla eşleşir.
`path_filter`	`str`	Hayır	-	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`	`str`	Hayır	-	Dil filtresi
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`per_hop_limit`	`int`	Hayır	-	Hop başına maksimum ilişki sayısı (1-300)
`include_metrics`	`bool`	Hayır		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ş grafik ö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`	`Literal[summary, full]`	Hayır	`summary`	include_metrics=true: summary (varsayılan) karar sinyallerini + refactor_risk döndürdüğünde; full, daha büyük seçilmiş metrik kümesini döndürür
`include_edge_metadata`	`bool`	Hayır		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`	`bool`	Hayır	`true`	Varsayılan true: döndürülen grafik kenarlarından test, fikstür, satıcı ve örnek yolları hariç tutun. false'yi bunları içerecek şekilde ayarlayın.
`include_module_symbols`	`bool`	Hayır		from_name veya to_name sentetik __module__ sembolü olduğunda, varsayılan olarak false grafik kenarlarını hariç tutar. true'yi modül düzeyinde kenarları içerecek şekilde ayarlayın.

En İyi Kullanım:

Zaten onun response shape'ine (graph, connection_summary) bağlı legacy caller'lar

Önerilmeyen Kullanım:

Yeni agent loop'ları — aynı traversal core'unu paylaşan dependency_search'ü tercih edin

get_task_contextKararlı

Tanımadığınız bir alanda mı çalışmaya başlıyorsunuz? Görevi tanımlayın (örn. "SSO desteği ekle", "billing webhook'unu düzelt") ve ilgili dosyaların, kodun, symbol'lerin ve dependency'lerin sınırlı, tek çağrılık bir paketini alın. Seed edilen dosyalar, hiçbir symbol tanımlamasalar bile doğrudan indexed içerik katkısı sağlar. Daha fazla sonuç için o katman için özel search tool'una devam edin.

Parametreler:

task_descriptionZorunlu

Tür: str
Açıklama: Bağlam istediğiniz görev açıklaması

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

limitOpsiyonel

Tür: int
Varsayılan: 15
Açıklama: Katman başına maksimum sonuç

scopeOpsiyonel

Tür: Literal[semantic, symbols, dependencies, all]
Varsayılan: all
Açıklama: Hangi bağlam katmanlarının dahil edileceği

language_filterOpsiyonel

Tür: str
Açıklama: Dil filtresi

path_filterOpsiyonel

Tür: str
Açıklama: Dosya yolu önekine göre filtrele

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

include_related_contextOpsiyonel

Tür: bool
Varsayılan
Açıklama: Bitişik sembollerden ilgili bağlamı dahil et

seed_symbol_idsOpsiyonel

Tür: list[str]
Açıklama: Seviye-1 açık tohumlar: ajanın görevin merkezinde olduğunu bildiği sembol ID'leri (örn. açık olan dosyalardaki semboller). Keyword kaynaklı tohumlara göre önceliklidir. Toplayıcıdır — bugünkü yalnızca-kelime davranışı için boş bırakın.

seed_file_pathsOpsiyonel

Tür: list[str]
Açıklama: Tier-1 açık seed'ler: agent'ın açık olan veya az önce düzenlediği indexed dosya path'leri. Sınırlı doğrudan dosya kanıtı döndürür ve graph context için dosya başına 5 symbol'e kadar çözer, symbol içermeyen doküman ve config dahil. Katkı sağlar — keyword-only davranış için atlayın.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`task_description`	`str`	Evet	-	Bağlam istediğiniz görev açıklaması
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`limit`	`int`	Hayır	`15`	Katman başına maksimum sonuç
`scope`	`Literal[semantic, symbols, dependencies, all]`	Hayır	`all`	Hangi bağlam katmanlarının dahil edileceği
`language_filter`	`str`	Hayır	-	Dil filtresi
`path_filter`	`str`	Hayır	-	Dosya yolu önekine göre filtrele
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`include_related_context`	`bool`	Hayır		Bitişik sembollerden ilgili bağlamı dahil et
`seed_symbol_ids`	`list[str]`	Hayır	-	Seviye-1 açık tohumlar: ajanın görevin merkezinde olduğunu bildiği sembol ID'leri (örn. açık olan dosyalardaki semboller). Keyword kaynaklı tohumlara göre önceliklidir. Toplayıcıdır — bugünkü yalnızca-kelime davranışı için boş bırakın.
`seed_file_paths`	`list[str]`	Hayır	-	Tier-1 açık seed'ler: agent'ın açık olan veya az önce düzenlediği indexed dosya path'leri. Sınırlı doğrudan dosya kanıtı döndürür ve graph context için dosya başına 5 symbol'e kadar çözer, symbol içermeyen doküman ve config dahil. Katkı sağlar — keyword-only davranış için atlayın.

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_fileKararlı

İndexed repo'dan path'e göre bir dosya okuyun. Diskteki dosyalar için yerel Read tool'unu tercih edin — bunu, dosya working tree'nizde olmadığında cross-repo veya remote aramalar için kullanın. Opsiyonel bir line range destekler; metadata.next_line_start'tan token-truncated bir yanıta devam edin.

Parametreler:

file_pathZorunlu

Tür: str
Açıklama: Depo köküne göre dosya yolu

repositoryOpsiyonel

Tür: str
Açıklama: Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.

line_startOpsiyonel

Tür: int
Açıklama: Başlangıç satırı (1-index)

line_endOpsiyonel

Tür: int
Açıklama: Bitiş satırı (1-indexed, dahil; line_start'a eşit veya sonrasında olmalı)

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

max_tokensOpsiyonel

Tür: int
Varsayılan: 5000
Açıklama: Döndürülecek maksimum token

include_metadataOpsiyonel

Tür: bool
Varsayılan: true
Açıklama: Yanıta dosya meta verisini dahil et

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`file_path`	`str`	Evet	-	Depo köküne göre dosya yolu
`repository`	`str`	Hayır	-	Depo owner/repo[:branch] biçiminde. İsteğe bağlı — MCP istemciniz istek kapsamlı bir varsayılan sağlıyorsa veya anahtar tam olarak bir depoya erişebiliyorsa belirtmeyin; farklı bir indekslenmiş depoyu hedeflemek için yalnızca açıkça iletin. Yanıt, hangi deponun kullanıldığını gösterir.
`line_start`	`int`	Hayır	-	Başlangıç satırı (1-index)
`line_end`	`int`	Hayır	-	Bitiş satırı (1-indexed, dahil; line_start'a eşit veya sonrasında olmalı)
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`max_tokens`	`int`	Hayır	`5000`	Döndürülecek maksimum token
`include_metadata`	`bool`	Hayır	`true`	Yanıta dosya meta verisini dahil et

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_contextKararlı

Arayabileceğiniz repository'leri listeleyin veya biri hakkında identity bilgisi alın (namespace/branch, indexed_commit_sha / index freshness). Search tool'larının kabul ettiği tam repo slug'ını öğrenmek için bir kez action:"list" ile çağırın. (Anahtarınızda tek bir repo varsa, search tool'ları buna varsayılan olarak ayarlanır — atlayabilirsiniz.) Namespace genelindeki file/blob/edge sayıları include_statistics=true ile opsiyoneldir.

Parametreler:

actionZorunlu

Tür: Literal[list, info]
Açıklama: İşlem: erişilebilir depoları listele veya depo bilgisi al

repositoryOpsiyonel

Tür: str
Açıklama: Bilgi için owner/repo veya owner/repo:branch biçiminde depo (info için gerekli)

branchOpsiyonel

Tür: str
Açıklama: Dal geçersiz kılma

patternOpsiyonel

Tür: str
Açıklama: Depo listesini kalıba göre filtrele

include_statisticsOpsiyonel

Tür: bool
Varsayılan
Açıklama: Opsiyonel: namespace genelindeki indexed-data sayılarını (file/blob/edge) dahil edin. Varsayılan false — repository identity'si bu daha yavaş agregasyonu gerektirmez.

limitOpsiyonel

Tür: int
Varsayılan: 20
Açıklama: Bu sayfada döndürülen maksimum sonuç sayısı

offsetOpsiyonel

Tür: int
Açıklama: Kullanımdan kaldırılan uyumluluk dengelemesi. pagination.next_cursor'den cursor'yi tercih edin.

cursorOpsiyonel

Tür: str
Açıklama: pagination.next_cursor'den opak cursor. Değiştirmeden iletin ve sorguyu ve filtreleri değiştirmeden tutun.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`action`	`Literal[list, info]`	Evet	-	İşlem: erişilebilir depoları listele veya depo bilgisi al
`repository`	`str`	Hayır	-	Bilgi için owner/repo veya owner/repo:branch biçiminde depo (info için gerekli)
`branch`	`str`	Hayır	-	Dal geçersiz kılma
`pattern`	`str`	Hayır	-	Depo listesini kalıba göre filtrele
`include_statistics`	`bool`	Hayır		Opsiyonel: namespace genelindeki indexed-data sayılarını (file/blob/edge) dahil edin. Varsayılan false — repository identity'si bu daha yavaş agregasyonu gerektirmez.
`limit`	`int`	Hayır	`20`	Bu sayfada döndürülen maksimum sonuç sayısı
`offset`	`int`	Hayır	-	Kullanımdan kaldırılan uyumluluk dengelemesi. pagination.next_cursor'den cursor'yi tercih edin.
`cursor`	`str`	Hayır	-	pagination.next_cursor'den opak cursor. Değiştirmeden iletin ve sorguyu ve filtreleri değiştirmeden tutun.

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_maguyvaKararlı

Maguyva yardımı ve geri bildirimi. Birincil: tool guidance alın veya Maguyva'nın maintainer'ları için saklanan bir bug report / feature request gönderin. Geri bildirimde asla secret veya hassas kişisel veri paylaşmayın. evaluate operasyonu yalnızca geriye dönük uyumluluk için kalır — math/hash/string işleri için yerel hesaplama veya host tool'larını tercih edin.

Parametreler:

operationZorunlu

Tür: Literal[guidance, report_bug, request_feature, evaluate]
Açıklama: Birincil: guidance, report_bug, request_feature. Yalnızca legacy/uyumluluk: evaluate (deterministic expression engine; birincil agent workflow'unun parçası değil).

queryOpsiyonel

Tür: str
Açıklama: Guidance konusu (örn. tool_selection, semantic_search). Yalnızca legacy evaluate için: expression string'i.

descriptionOpsiyonel

Tür: str
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_toolOpsiyonel

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ı

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`operation`	`Literal[guidance, report_bug, request_feature, evaluate]`	Evet	-	Birincil: guidance, report_bug, request_feature. Yalnızca legacy/uyumluluk: evaluate (deterministic expression engine; birincil agent workflow'unun parçası değil).
`query`	`str`	Hayır	-	Guidance konusu (örn. tool_selection, semantic_search). Yalnızca legacy evaluate için: expression string'i.
`description`	`str`	Hayır	-	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`	`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]`	Hayır	-	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:

Math/hash/string hesaplama — evaluate operasyonu yalnızca geriye dönük uyumluluk için kalır; yerel host hesaplamasını tercih edin

En İyi Uygulamalar#

Açık Geçersiz Kılmaları Bilinçli Kullanın: MCP istemciniz bir istek varsayılanı sağladığında veya anahtar tam olarak bir depoya erişebildiğinde depoyu atlayın; aksi halde açıkça iletin.
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.
Dil Filtrelerinden Yararlanın: language_filter ile sonuçları daraltın ve performansı artırın.
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.
Depo Eşleştirme Büyük/Küçük Harfe Duyarsızdır, Bulanık Değildir: repository_context, depo adlarını büyük/küçük harfe duyarsız şekilde eşleştirir — yazım hatalarını düzeltmez. Bir adın nasıl çözümlendiğini görmek için info eyleminde metadata.resolution_reason alanını kontrol edin ("exact" ile "corrected" karşılaştırması).
Araçları Birleştirin: Kapsamlı analiz için birden çok API yöntemini birlikte kullanın.
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).
Araç Rehberliği için ask_maguyva Kullanın: ask_maguyva evaluate işlemi (hash, base64, JSON, matematik) yalnızca eski / geriye dönük uyumluluk içindir. Bunun yerine yerel-araç-kazanır matrisi ve araç bazında eksiksiz bir hile sayfası için ask_maguyva aracını operation="guidance" ve query="tool_selection" ile çağırın.
Düzenlemeden Önce ve Sonra Etkiyi Doğrulayın: Paylaşılan bir sembolü düzenlemeden önce, etki alanı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.

Performans Özellikleri#

İşlem	Performans notları
Anlamsal arama	Saniyenin altında, ancak her seferinde canlı bir embedding API çağrısı içerir (önbelleğe alınmaz) — vektör sorgusuna ek olarak gecikme bekleyin
Metin arama	Tam eşleşme/regex için saniyenin altında; bulanık içerik araması istemci tarafında sayfalanır, bu yüzden derin ofsetler daha maliyetlidir — path_filter/language_filter ile daraltın
Yapısal arama	AST ile indekslenmiştir — maliyet repo boyutuna değil, sonuç hacmine göre ölçeklenir
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	Tek bir dosya için neredeyse anında — büyük dosyaları tek seferde çekmek yerine line_start/line_end veya max_tokens ile sayfalayın
Repo bağlamı	Ad alanı çözümlemesi yalnızca istek başına önbelleğe alınır, çağrılar arasında değil — her araç çağrısı yeniden çözümler
ask_maguyva (guidance / evaluate)	Neredeyse anında — veritabanı çağrısı olmadan Worker içinde çalışır

Hata Yönetimi#

Tüm API yöntemleri yapılandırılmış bir zarf döndürür:

status: String — "success" veya "error". Bozulmuş eşleşme ve güncellik sinyalleri, repository_context üzerindeki metadata.resolution_reason veya metadata.index_freshness.status gibi iç içe alanlarda bulunur.
tool: Yanıtı üreten aracın adı
data: Başarılı olduğunda sonuç yükü (yapı araca göre değişir)
error: status değeri "error" olduğunda yapılandırılmış hata nesnesi — type, message, suggestions ve recovery_actions içerir
metadata: İşlem hakkında ek bilgi (yönlendirme, önbellekleme, parametre ayarlamaları)
pagination: Liste yanıtlarında bulunur — has_more ve next_cursor içerir

Sonuçları işlemeden önce her zaman status alanını kontrol edin — bu alan yalnızca "success" veya "error" olabilir. Bozulmuş eşleşme veya güncellik sinyalleri için bunun yerine iç içe alanı okuyun: repository_context üzerindeki metadata.resolution_reason veya metadata.index_freshness.status (known/partial/unknown/unavailable).

Başlarken#

MCP İstemcisini Yapılandır: MCP istemcinizi Maguyva sunucu uç noktasına yönlendirin
Depo Erişimini Doğrulayın: API anahtarının erişebildiği depoları görmek için repository_context ile list veya info kullanın
Aramaya Başlayın: Doğal dil sorgusu verip intelligent_search ile başlayın; gerekirse özel araçları keşfedin
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.