Αναφορά MCP API

Εξερευνήστε τα 11 εργαλεία MCP του Maguyva, τις παραμέτρους τους και πότε να χρησιμοποιείτε το καθένα. Ελέγξτε την απάντηση tools/list του συνδεδεμένου πελάτη σας για τα διαθέσιμα ορίσματα.

Τα εργαλεία οργανώνονται σε 4 κατηγορίες:

• Βασικά εργαλεία αναζήτησης - Προηγμένες δυνατότητες αναζήτησης σε όλο τον κώδικά σας
• Εργαλεία δομής & γράφου - Ερωτήματα AST, αναζήτηση συμβόλων και ανάλυση εξαρτήσεων
• Εργαλεία ανάλυσης κώδικα - Βαθιά ανάλυση κώδικα και χαρτογράφηση σχέσεων
• Εργαλεία συστήματος & βοηθητικά - Πλαίσιο αποθετηρίου, καθοδήγηση εργαλείων και σχόλια

Για εργαλεία που δέχονται αποθετήριο, χρησιμοποιήστε αυτή τη μορφή μορφή αναγνωριστικού αποθετηρίου: "owner/repo:branch". Ο προεπιλεγμένος κλάδος είναι main αν δεν οριστεί.

Παραλείψτε το repository όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά. Χρησιμοποιήστε το repository_context(action="info", repository="owner/repo") για να ελέγξετε πώς επιλύεται ένα αποθετήριο.

Χρησιμοποιήστε αυτές τις μορφές όταν ορίζετε αποθετήριο:

• Με κλάδο: "owner/repo:branch" - π.χ., "owner/repository:develop"
• Προεπιλεγμένος κλάδος: "owner/repo" - χρησιμοποιεί τον κλάδο main όταν δεν καθορίζεται κλάδος "owner/repository"
• Προεπιλογή αιτήματος ή μοναδικού αποθετηρίου: Παραλείψτε το αποθετήριο όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά

Παραδείγματα προτροπών:

Ρωτήστε για ένα συγκεκριμένο repo:  "Αναζήτηση owner/my-repo για ενδιάμεσο λογισμικό ελέγχου ταυτότητας"
Λίστα προσβάσιμων αποθετηρίων:      "Σε ποια αποθετήρια έχει πρόσβαση αυτό το κλειδί Maguyva;"
Παράκαμψη για ένα ερώτημα:          "Αναζήτηση owner/other-repo:develop για μοτίβα auth"

Χρησιμοποιήστε language_filter στις λειτουργίες αναζήτησης που το υποστηρίζουν. Για text_pattern_search, επιλέξτε search_scope="content"· για get_task_context, χρησιμοποιήστε scope="semantic" χωρίς σημεία εκκίνησης ή σχετικό πλαίσιο.

• language_filter="python" - Φιλτράρισμα μόνο σε αρχεία Python
• language_filter="typescript" - Φιλτράρισμα μόνο σε αρχεία TypeScript
• Διάκριση πεζών-κεφαλαίων: Χρησιμοποιήστε ονόματα γλωσσών με πεζά
• Προεπιλογή: Κενή συμβολοσειρά (χωρίς φιλτράρισμα) - επιστρέφει αποτελέσματα από όλες τις γλώσσες
• Υποστηριζόμενη κάλυψη: Τα φίλτρα γλώσσας λειτουργούν σε 285+ υποστηριζόμενες γλώσσες και τεχνολογίες βασισμένες σε κείμενο. Δείτε τη συμβατότητα για την πλήρη λίστα.

"Βρες authentication middleware μόνο σε αρχεία Python"
"Αναζήτησε συνδέσεις βάσης δεδομένων σε TypeScript"

Η αναφορά API δημιουργήθηκε από την πηγή στις 21 Οκτωβρίου 2026.

1. Χρησιμοποιήστε σκόπιμα ρητές παρακάμψεις: Παραλείψτε το αποθετήριο όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά.
2. Επιλέξτε τη σωστή λειτουργία αναζήτησης: Χρησιμοποιήστε το intelligent_search με το mode="auto" για τις περισσότερες περιπτώσεις. Καθορίστε μια λειτουργία όταν γνωρίζετε ακριβώς τι χρειάζεστε.
3. Αξιοποιήστε τα φίλτρα γλώσσας: Χρησιμοποιήστε το language_filter για να περιορίσετε τα αποτελέσματα και να βελτιώσετε την απόδοση.
4. Ενίσχυση GraphRAG: Η ενίσχυση σημασίας GraphRAG είναι απενεργοποιημένη από προεπιλογή για τη σημασιολογική αναζήτηση (boost_by_importance=false) ώστε η κατάταξη να παραμένει ασφαλής για πράκτορες. Περάστε boost_by_importance=true για να ενεργοποιήσετε την επανακατάταξη με επίγνωση κεντρικότητας για ξεναγήσεις αρχιτεκτονικής.
5. Η αντιστοίχιση αποθετηρίων δεν διακρίνει πεζά-κεφαλαία, δεν είναι ασαφής: Το repository_context αντιστοιχίζει ονόματα αποθετηρίων χωρίς διάκριση πεζών-κεφαλαίων — δεν διορθώνει όμως τυπογραφικά λάθη. Όταν η ταυτότητα που αποδίδεται διαφέρει από αυτήν που ζητήθηκε, το metadata.resolution_reason αναφέρει "defaulted" (δεν ζητήθηκε κλάδος) ή "fallback" (ο κλάδος ή το αποθετήριο που ζητήθηκε δεν είναι διαθέσιμο). Το πεδίο παραλείπεται όταν το αίτημα ταίριαξε ακριβώς.
6. Συνδυάστε εργαλεία: Χρησιμοποιήστε πολλές μεθόδους API μαζί για ολοκληρωμένη ανάλυση.
7. Χειριστείτε μεγάλα αποτελέσματα: Χρησιμοποιήστε limit και χειριστήρια σελιδοποίησης ειδικά για το εργαλείο (για παράδειγμα line_start/line_end στο get_file).
8. Χρησιμοποιήστε το ask_maguyva για καθοδήγηση εργαλείων: Καλέστε το ask_maguyva με operation="guidance" και query="tool_selection" για συμβουλές επιλογής εργαλείων και παραδείγματα. Χρησιμοποιήστε τα τοπικά εργαλεία σας για υπολογισμούς και μετασχηματισμούς συμβολοσειρών.
9. Επαληθεύστε τον αντίκτυπο πριν και μετά την επεξεργασία: Πριν αλλάξετε ένα κοινόχρηστο σύμβολο, καλέστε dependency_search με analysis_type="impact" (ή δώστε changed_paths για τον αντίκτυπο PR/diff), ώστε να δείτε την ακτίνα επίδρασης. Μετά την αλλαγή, ορίστε verify_after_edit=true με targets και/ή changed_paths για έναν συνοπτικό επανέλεγχο του ευρετηριασμένου γράφου. Αυτό δεν διαβάζει τοπικές αλλαγές χωρίς commit ούτε αντικαθιστά τις τοπικές δοκιμές. Ελέγξτε το indexed_commit_sha και την επικαιρότητα του ευρετηρίου πριν θεωρήσετε τα αποτελέσματα τεκμήριο για μια νέα αναθεώρηση.

Οι απαντήσεις εργαλείων περιέχουν κοινά πεδία κατάστασης και πεδία δεδομένων ειδικά για κάθε εργαλείο στο ανώτερο επίπεδο. Οι αναζητήσεις επιστρέφουν results· το get_file επιστρέφει content. Τα κοινά πεδία περιλαμβάνουν:

• status: Συμβολοσειρά — "success" ή "error". Τα σήματα υποβαθμισμένης αντιστοίχισης και φρεσκάδας έχουν δικά τους πεδία: metadata.resolution_reason κάτω από το metadata, και index_freshness.status στο ανώτατο επίπεδο της ενέργειας info του repository_context.
• timing_ms: Χρόνος εκτέλεσης του εργαλείου που έχει παρέλθει, σε χιλιοστά του δευτερολέπτου
• applied_filters: Οι πραγματικές παράμετροι αιτήματος που καταγράφηκαν για τη λειτουργία
• error: Συμβολοσειρά μηνύματος σφάλματος όταν το status είναι "error"· μπορεί να περιλαμβάνει οδηγίες αποκατάστασης.
• metadata: Επιπλέον πληροφορίες για τη λειτουργία (δρομολόγηση, προσωρινή αποθήκευση, προσαρμογές παραμέτρων)
• pagination: Παρουσιάζεται σε απαντήσεις συλλογών με σελιδοποίηση μέσω δρομέα — περιλαμβάνει has_more και next_cursor. Τα ταξινομημένα παράθυρα αναζήτησης είναι περιορισμένα αποτελέσματα top-K, όχι εξαντλητικές σελιδοποιημένες συλλογές.

Ελέγξτε το πεδίο status πριν επεξεργαστείτε το ωφέλιμο φορτίο ενός εργαλείου — οι τιμές του είναι "success" ή "error". Χειριστείτε επίσης σφάλματα μεταφοράς MCP/JSON-RPC και επικύρωσης αιτήματος, τα οποία μπορεί να προκύψουν πριν καν παραχθεί φορτίο. Για σήματα υποβαθμισμένης αντιστοίχισης ή φρεσκάδας διαβάστε το αντίστοιχο ειδικό πεδίο: metadata.resolution_reason κάτω από το metadata, ή index_freshness.status στο ανώτατο επίπεδο της ενέργειας info του repository_context (known/partial/unknown/unavailable).

1. Διαμόρφωση MCP client: Κατευθύνετε τον MCP client στο endpoint του διακομιστή Maguyva
2. Επιβεβαίωση πρόσβασης σε αποθετήρια: Χρησιμοποιήστε το repository_context με "list" ή "info" για να ελέγξετε τα αποθετήρια που είναι διαθέσιμα στο κλειδί API
3. Έναρξη αναζήτησης: Ξεκινήστε με το intelligent_search και εξερευνήστε εξειδικευμένα εργαλεία όταν χρειάζεται
4. Συνδυασμός εργαλείων: Χρησιμοποιήστε πολλά εργαλεία μαζί για ολοκληρωμένη ανάλυση κώδικα

Για αναλυτικές οδηγίες ενσωμάτωσης, δείτε τον οδηγό εγκατάστασης.