DeepWiki ir tinkinti įrankiai
Šiame puslapyje
DeepWiki: viešas serveris praktikai
Viskas, ką iki šiol matei, lieka abstraktu, kol neprijungi tikro serverio. DeepWiki yra idealus kandidatas šiam pirmajam testui: jis pateikia viešą MCP serverį adresu https://mcp.deepwiki.com/mcp be autentifikacijos, suteikiantį prieigą prie bet kurio GitHub projekto dokumentacijos.
Konfigūracija užima tik kelias eilutes, nes vienintelis čia tikrai svarbus neprivalomas parametras yra aprašymas.
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."
)
]
Kai šis ryšys užmegztas, užduok Grok klausimus, kuriems iš tiesų reikia skaityti saugyklą: „paaiškink, kaip maršrutizavimas veikia facebook/react projekte“, „kokios yra vercel/next.js konfigūracijos parinktys?“ arba „parodyk langchain-ai/langchain projekto struktūrą“. Modelis iškviečia DeepWiki įrankius, gauna dokumentaciją ir šaltinio kodą, tada suformuoja struktūrizuotą atsakymą. Palygink šį atsakymą su tuo, ką gautum be MCP serverio: skirtumas tarp to, ką modelis žino, ir to, ką jis ką tik perskaitė, yra akivaizdus iškart.
Perėjimas prie savo serverių
DeepWiki yra puiki treniruočių aikštelė, tačiau tikroji MCP vertė atsiskleidžia tada, kai serveris atskleidžia tai, ko niekas kitas neturi: tavo duomenis, tavo procesus, tavo verslo įrankius.
Techniškai MCP serveris yra žiniatinklio programa, atsakanti į dviejų tipų užklausas. Pirmiausia – atradimas: kai Grok prisijungia, jis prašo available įrankių sąrašo su jų schemomis. Antra – vykdymas: kai modelis nusprendžia iškviepti įrankį, jis perduoda įrankio pavadinimą ir jo argumentus, tada laukia rezultato. Serveris privalo pateikti MCP protokolui atitinkantį HTTPS galinį tašką, naudodamas „Streaming HTTP“ arba SSE – du perdavimo būdus, nagrinėtus kurso pradžioje.
Tinkintą serverį daro įdomiu ne technika, o jo skelbiamų įrankių pasirinkimas. Štai trys nuoseklaus skaidymo pavyzdžiai, kai kiekvienas serveris apima vieną ir tik vieną sritį:
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
Šis skaidymas pagal sritis nėra tik dėl grožio: jis leidžia taikyti skirtingus autentifikacijos lygius ir serverio apribojimus kiekvienam serveriui atskirai, užuot taikius vieną taisyklę mišriam heterogeniškų įrankių rinkiniui. Kai serveris bus diegtas, prisijungimas vyksta lygiai taip pat, kaip ir DeepWiki atveju, tik papildomas prieigos raktu ir leidžiamų įrankių sąrašu.
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"]
)
]
Vieši ir vidiniai serveriai toje pačioje sesijoje
Konfigūracijos tampa tikrai įdomios, kai sumaišai abi šeimas, nes tada modelis gali susieti viešą šaltinį su šaltiniu, prieinamu tik tau.
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"]
),
]
Tada paprašyk Grok palyginti oficialią React dokumentaciją su tavo vidine architektūros gaire apie maršrutizavimą: jis užklausia DeepWiki dėl pirmosios, o tavo dokumentacijos serverio – dėl antrosios, tada jas sugretina. Joks modelis negali sukurti tokio atsakymo remdamasis tik savo žiniomis, to negali padaryti ir žiniatinklio paieška, nes pusė medžiagos egzistuoja tik tavo įmonėje.
Galiausiai atkreipk dėmesį, kaip skirtingai sukonfigūruoti šie trys serveriai. Viešas serveris neturi nei prieigos rakto, nei leidžiamų įrankių sąrašo; vidinė dokumentacija turi prieigos raktą, bet lieka gana atvira, nes yra tik skaitymui; o verslo duomenys derina prieigos raktą ir griežtą apribojimą tik trims operacijoms. Kiekvienas serveris turi tokį valdymo lygį, kokį pateisina jo turinys – būtent tai ir yra atskirų serverių kūrimo esmė.
Svarbiausi punktai
- DeepWiki (
https://mcp.deepwiki.com/mcp) yra paruoštas naudoti viešas MCP serveris GitHub dokumentacijai - Gali kurti savo MCP serverius, kad eksponuotum įrankius, specifinius tavo verslui
- Tinkintas MCP serveris yra HTTPS žiniatinklio programa, atsakanti į atradimo ir vykdymo užklausas
- Viešų ir vidinių serverių derinimas suteikia galingiausias konfigūracijas
- Kiekvienas serveris išlaiko savo autentifikacijos lygį ir įrankių apribojimus