Lähe põhisisu juurde
Eesti— Vali keel
Menüü

DeepWiki ja kohandatud tööriistad

Õppetund 9 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. DeepWiki: avalik server harjutamiseks
  2. Liikumine oma serverite juurde
  3. Avalikud ja sisemised serverid samas sessioonis
  4. Peamised punktid

DeepWiki: avalik server harjutamiseks

Kõik seninähtu jääb abstraktseks, kuni ühendad reaalse serveriga. DeepWiki on selleks esimeseks katsetuseks ideaalne kandidaat: see pakub avalikku MCP serverit aadressil https://mcp.deepwiki.com/mcp ilma autentimiseta, võimaldades juurdepääsu ükskõik millise GitHubi projekti dokumentatsioonile.

Seadistamine võtab vaid mõned read, kuna ainus siin oluline valikuline parameeter on kirjeldus.

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."
    )
]

Kui see ühendus on loodud, esita Grokile küsimusi, mis nõuavad tegelikult hoidla lugemist: „selgita, kuidas suunamine toimib facebook/react projektis“, „millised on vercel/next.js konfiguratsioonivalikud?“ või „näita mulle langchain-ai/langchain projekti struktuuri“. Mudel kutsub DeepWiki tööriistu, hangib dokumentatsiooni ja lähtekoodi ning sünteesib seejärel struktureeritud vastuse. Võrdle seda vastust sellega, mida saaksid ilma MCP serverita: erinevus mudeli eelteadmiste ja just loetu vahel on koheselt ilmne.

Liikumine oma serverite juurde

DeepWiki on suurepärane harjutusplats, kuid MCP tegelik väärtus avaldub siis, kui server paljastab seda, mida keegi teine ei saa: sinu andmed, sinu protsessid, sinu äritööriistad.

Tehniliselt on MCP server veebirakendus, mis vastab kahte tüüpi päringutele. Esiteks avastamine: kui Grok ühendub, küsib ta saadaolevate tööriistade loendit koos nende skeemidega. Teiseks täitmine: kui mudel otsustab tööriista kutsuda, edastab ta tööriista nime ja selle argumendid ning ootab seejärel tulemust. Server peab pakkuma HTTPS lõpppunkti, mis järgib MCP protokolli, kasutades Streaming HTTP-d või SSE-d – kahte ülekandeviisi, mida käsitlesime kursuse alguses.

Kohandatud serveri puhul ei ole huvitav mitte tehnika, vaid avaldatavate tööriistade valik. Siin on kolm näidet kooskõlaliseks jaotamiseks, kus iga server katab ühe ja ainult ühe valdkonna:

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

See valdkondadeks jaotamine ei ole pelgalt ilu pärast: see võimaldab rakendada iga serveri kohta erinevaid autentimise tasemeid ja serveripiiranguid, selle asemel et kohaldada ühte reeglit segasele heterogeensete tööriistade kogumile. Kui sinu server on kasutusele võetud, järgib ühendamine täpselt DeepWiki mustrit, mida on täiendatud tokeni ja lubatud nimekirjaga.

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"]
    )
]

Avalikud ja sisemised serverid samas sessioonis

Konfiguratsioonid muutuvad tõeliselt huvitavaks, kui segad mõlemat perekonda, sest siis saab mudel korreleerida avaliku allika ainult sinule kuuluva allikaga.

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"]
    ),
]

Seejärel palu Grokil võrrelda ametlikku Reacti dokumentatsiooni oma sisemise arhitektuurijuhendiga suunamise kohta: ta pärib esimese jaoks DeepWikist ja teise jaoks sinu dokumentatsiooniserverist ning seejärel seab need vastamisi. Ükski mudel ei suuda seda vastust toota ainult omaenda teadmiste põhjal ja seda ei suuda ka veebiotsing, kuna pool materjalist eksisteerib ainult sinu ettevõttes.

Pane tähele lõpuks, kuidas kolme serverit on erinevalt seadistatud. Avalikul serveril puudub nii token kui ka lubatud nimekiri, sisemiselle dokumentatsioonile on määratud token, kuid see jääb suuresti avatuks, kuna on ainult lugemisõigusega, ning äriandmed kombineerivad tokenit ja ranget piirangut kolmele operatsioonile. Iga server kannab oma sisu poolt õigustatud kontrollitaset – see ongi nende eraldamise mõte.

Peamised punktid

  • DeepWiki (https://mcp.deepwiki.com/mcp) on valmis kasutamiseks avalik MCP server GitHubi dokumentatsiooni jaoks
  • Saad luua oma MCP servereid, et paljastada oma äritegevusele omaseid tööriistu
  • Kohandatud MCP server on HTTPS veebirakendus, mis vastab avastamis- ja täitmispäringutele
  • Avalike ja sisemiste serverite kombineerimine annab võimsaimad konfiguratsioonid
  • Iga server haldab oma autentimise taset ja tööriistade piiranguid