Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

DeepWiki και Προσαρμοσμένα Εργαλεία

Μάθημα 9 / 12 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. DeepWiki: Ένας Δημόσιος Διακομιστής για Εξάσκηση
  2. Μετάβαση στους Δικούς σας Διακομιστές
  3. Δημόσιοι και Εσωτερικοί Διακομιστές στην Ίδια Συνεδρία
  4. Βασικά σημεία

DeepWiki: Ένας Δημόσιος Διακομιστής για Εξάσκηση

Όλα όσα έχετε δει μέχρι τώρα παραμένουν αφηρημένα έως ότου συνδεθείτε με έναν πραγματικό διακομιστή. Το DeepWiki είναι ο ιδανικός υποψήφιος για αυτή την πρώτη δοκιμή: εκθέτει έναν δημόσιο διακομιστή MCP στη διεύθυνση https://mcp.deepwiki.com/mcp, χωρίς απαίτηση πιστοποίησης, ο οποίος παρέχει πρόσβαση στην τεκμηρίωση οποιουδήποτε έργου στο GitHub.

Η διαμόρφωση απαιτεί μόνο λίγες γραμμές, καθώς η μόνη προαιρετική παράμετρος που έχει πραγματικά σημασία εδώ είναι η περιγραφή.

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentation for open-source GitHub projects. Search and view code, READMEs, guides."
    )
]

Μόλις establishθεί αυτή η σύνδεση, κάντε ερωτήσεις στο Grok που απαιτούν πραγματικά την ανάγνωση του αποθετηρίου: «εξηγήστε πώς λειτουργεί η δρομολόγηση στο έργο facebook/react», «ποιες είναι οι επιλογές διαμόρφωσης για το vercel/next.js;» ή «εμφανίστε μου τη δομή του έργου για το langchain-ai/langchain». Το μοντέλο καλεί τα εργαλεία του DeepWiki, ανακτά την τεκμηρίωση και τον πηγαίο κώδικα, και στη συνέχεια συνθέτει μια δομημένη απάντηση. Συγκρίνετε αυτή την απάντηση με αυτή που θα λαμβάνατε χωρίς τον διακομιστή MCP: η διαφορά μεταξύ όσων γνωρίζει το μοντέλο και όσων μόλις διάβασε είναι άμεσα εμφανής.

Μετάβαση στους Δικούς σας Διακομιστές

Το DeepWiki αποτελεί εξαιρετικό πεδίο εκπαίδευσης, αλλά η πραγματική αξία του MCP αναδεικνύεται όταν ο διακομιστής εκθέτει δεδομένα που κανείς άλλος δεν διαθέτει: τα δικά σας δεδομένα, τις διαδικασίες σας, τα επιχειρηματικά σας εργαλεία.

Τεχνικά, ένας διακομιστής MCP είναι μια διαδικτυακή εφαρμογή που ανταποκρίνεται σε δύο τύπους αιτημάτων. Πρώτον, η ανακάλυψη: όταν το Grok συνδέεται, ζητά τη λίστα των διαθέσιμων εργαλείων μαζί με τα σχήματά τους. Δεύτερον, η εκτέλεση: όταν το μοντέλο αποφασίσει να καλέσει ένα εργαλείο, μεταδίδει το όνομα του εργαλείου και τα ορίσματά του, και στη συνέχεια περιμένει το αποτέλεσμα. Ο διακομιστής πρέπει να εκθέτει ένα endpoint HTTPS συμβατό με το πρωτόκολλο MCP, χρησιμοποιώντας Streaming HTTP ή SSE—τις δύο μεθόδους μεταφοράς που καλύφθηκαν στην αρχή του μαθήματος.

Αυτό που καθιστά έναν προσαρμοσμένο διακομιστή ενδιαφέροντα δεν είναι η τεχνική, αλλά η επιλογή των εργαλείων που δημοσιεύει. Ακολουθούν τρία παραδείγματα συνεκτικού διαχωρισμού, όπου κάθε διακομιστής καλύπτει έναν και μόνο έναν τομέα:

Server "analytics":
  - get_dashboard_metrics: dashboard metrics
  - query_events: query analytic events
  - get_funnel_report: conversion funnel report

Server "content":
  - search_articles: search within the CMS
  - get_article: retrieve a full article
  - list_categories: list content categories

Server "devops":
  - get_deploy_status: status of the last deployment
  - list_alerts: active monitoring alerts
  - get_service_health: health of a specific service

Αυτός ο διαχωρισμός ανά τομέα δεν είναι απλώς για εντυπωσιασμό: σας επιτρέπει να εφαρμόζετε διαφορετικά επίπεδα πιστοποίησης και περιορισμών διακομιστή ανά διακομιστή, αντί να επιβάλλετε έναν ενιαίο κανόνα σε ένα ετερογενές μείγμα εργαλείων. Μόλις αναπτυχθεί ο διακομιστής σας, η σύνδεση ακολουθεί ακριβώς το πρότυπο του DeepWiki, εμπλουτισμένο με το διακριτικό (token) και τη λίστα επιτρεπόμενων εργαλείων (allowlist).

tools = [
    mcp(
        server_url="https://mcp.yourcompany.com/analytics",
        server_label="analytics",
        server_description="Analytics metrics and reports. Dashboards, funnels, events.",
        authorization=f"Bearer {os.getenv('ANALYTICS_TOKEN')}",
        allowed_tool_names=["get_dashboard_metrics", "query_events"]
    )
]

Δημόσιοι και Εσωτερικοί Διακομιστές στην Ίδια Συνεδρία

Οι διαμορφώσεις γίνονται πραγματικά ενδιαφέρουσες όταν συνδυάζετε και τις δύο κατηγορίες, καθώς τότε το μοντέλο μπορεί να συσχετίσει μια δημόσια πηγή με μια πηγή στην οποία έχετε πρόσβαση μόνο εσείς.

tools = [
    # Public server for open-source documentation
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentation for open-source GitHub projects"
    ),
    # Internal server for product documentation
    mcp(
        server_url="https://docs.yourcompany.com/mcp",
        server_label="internal-docs",
        server_description="Internal technical documentation, architecture guides, ADRs",
        authorization=f"Bearer {os.getenv('DOCS_TOKEN')}"
    ),
    # Internal server for business data
    mcp(
        server_url="https://api.yourcompany.com/mcp",
        server_label="data",
        server_description="Business data: customers, orders, inventory",
        authorization=f"Bearer {os.getenv('API_TOKEN')}",
        allowed_tool_names=["search_customers", "get_order", "check_inventory"]
    ),
]

Στη συνέχεια, ζητήστε από το Grok να συγκρίνει την επίσημη τεκμηρίωση του React με τον εσωτερικό σας οδηγό αρχιτεκτονικής σχετικά με τη δρομολόγηση: θα queried το DeepWiki για το πρώτο και τον διακομιστή τεκμηρίωσής σας για το δεύτερο, και στη συνέχεια θα αντιπαραβάλει τα δύο. Κανένα μοντέλο δεν μπορεί να παράγει αυτή την απάντηση βασισμένο αποκλειστικά στις δικές του γνώσεις, ούτε μπορεί να το κάνει η αναζήτηση στον ιστό, καθώς το μισό υλικό υπάρχει μόνο στην εταιρεία σας.

Παρατηρήστε τέλος πώς οι τρεις διακομιστές έχουν διαμορφωθεί διαφορετικά. Ο δημόσιος διακομιστής δεν έχει ούτε διακριτικό ούτε λίστα επιτρεπόμενων εργαλείων, η εσωτερική τεκμηρίωση έχει διακριτικό αλλά παραμένει σε μεγάλο βαθμό ανοιχτή επειδή είναι μόνο για ανάγνωση, και τα επιχειρηματικά δεδομένα συνδυάζουν διακριτικό με αυστηρό περιορισμό σε τρεις λειτουργίες. Κάθε διακομιστής φέρει το επίπεδο ελέγχου που δικαιολογεί το περιεχόμενό του—αυτό είναι ακριβώς το νόημα του διαχωρισμού τους.

Βασικά σημεία

  • Το DeepWiki (https://mcp.deepwiki.com/mcp) είναι ένας έτοιμος προς χρήση δημόσιος διακομιστής MCP για τεκμηρίωση GitHub
  • Μπορείτε να δημιουργήσετε τους δικούς σας διακομιστές MCP για να εκθέσετε εργαλεία ειδικά για την επιχείρησή σας
  • Ένας προσαρμοσμένος διακομιστής MCP είναι μια διαδικτυακή εφαρμογή HTTPS που ανταποκρίνεται σε αιτήματα ανακάλυψης και εκτέλεσης
  • Ο συνδυασμός δημόσιων και εσωτερικών διακομιστών αποδίδει τις πιο ισχυρές διαμορφώσεις
  • Κάθε διακομιστής διατηρεί το δικό του επίπεδο πιστοποίησης και περιορισμού εργαλείων