DeepWiki a vlastné nástroje
Na tejto strane
DeepWiki: Verejný server na precvičovanie
Všetko, čo si doteraz videl, zostáva abstraktné, kým nepripojíš skutočný server. DeepWiki je ideálnym kandidátom na tento prvý test: vystavuje verejný MCP server na adrese https://mcp.deepwiki.com/mcp bez overovania, ktorý poskytuje prístup k dokumentácii pre akýkoľvek projekt na GitHub-e.
Konfigurácia zaberie len pár riadkov, keďže jediným voliteľným parametrom, na ktorom tu záleží, je popis.
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."
)
]
Akonáhle je toto spojenie nadviazané, polož Groku otázky, ktoré si skutočne vyžadujú čítanie repozitára: „vysvetli, ako funguje smerovanie v projekte facebook/react“, „aké sú možnosti konfigurácie pre vercel/next.js?“ alebo „ukáž mi štruktúru projektu langchain-ai/langchain“. Model zavolá nástroje DeepWiki, získa dokumentáciu a zdrojový kód a následne syntetizuje štruktúrovanú odpoveď. Porovnaj túto odpoveď s tým, čo by si dostal bez MCP servera: rozdiel medzi tým, čo model vie, a tým, čo práve prečítal, je okamžite zrejmý.
Prechod na vlastné servery
DeepWiki je vynikajúcim tréningovým priestorom, ale skutočná hodnota MCP sa prejaví až vtedy, keď server vystaví to, čo nikto iný nemôže: tvoje dáta, tvoje procesy, tvoje business nástroje.
Technicky je MCP server webová aplikácia, ktorá odpovedá na dva typy požiadaviek. Najprv objavovanie: keď sa Grok pripojí, vyžiada si zoznam dostupných nástrojov spolu s ich schémami. Následne exekúcia: keď sa model rozhodne zavolať nástroj, prenesie názov nástroja a jeho argumenty, potom čaká na výsledok. Server musí vystavovať koncový bod HTTPS kompatibilný s protokolom MCP s využitím Streaming HTTP alebo SSE – dvoch transportov, ktoré sme prebrali na začiatku kurzu.
To, čo robí vlastný server zaujímavým, nie je technika, ale výber nástrojov, ktoré publikuje. Tu sú tri príklady koherentného rozdelenia, kde každý server pokrýva jednu doménu a iba jednu:
Server "analytics":
- get_dashboard_metrics: metriky dashboardu
- query_events: dopytovanie analytických udalostí
- get_funnel_report: report lievika konverzie
Server "content":
- search_articles: vyhľadávanie v CMS
- get_article: získanie celého článku
- list_categories: zoznam kategórií obsahu
Server "devops":
- get_deploy_status: stav posledného nasadenia
- list_alerts: aktívne alerty monitoringu
- get_service_health: zdravotný stav konkrétnej služby
Toto rozdelenie podľa domén nie je len na oko: umožňuje ti nastaviť úrovne overovania a obmedzení servera pre každý server zvlášť, namiesto aplikovania jedného pravidla na zmiešanú zmes heterogénnych nástrojov. Akonáhle je tvoj server nasadený, pripojenie presne nasleduje vzor DeepWiki, rozšírený o token a zoznam povolených nástrojov (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"]
)
]
Verejné a interné servery v tej istej relácii
Konfigurácie sa stávajú skutočne zaujímavými, keď zmiešaš obe rodiny, pretože model potom môže korelovať verejný zdroj so zdrojom, ktorý máš iba ty.
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"]
),
]
Potom požiadaj Groka, aby porovnal oficiálnu dokumentáciu Reactu s tvojim interným architektonickým sprievodcom pre smerovanie: pre prvú časť sa opýta DeepWiki a pre druhú tvojho dokumentačného servera, následne obe strany skontrastuje. Žiadny model nedokáže vytvoriť túto odpoveď len na základe vlastných vedomostí a nedokáže to ani webové vyhľadávanie, keďže polovica materiálu existuje len vo tvojej firme.
Všimni si nakoniec, ako sú tri servery nakonfigurované odlišne. Verejný server nemá ani token, ani zoznam povolených nástrojov, interná dokumentácia má token, ale zostáva z veľkej časti otvorená, pretože je len na čítanie, a business dáta kombinujú token s prísnym obmedzením na tri operácie. Každý server nesie úroveň kontroly, ktorú jeho obsah odôvodňuje – presne o to ide pri ich separácii.
Kľúčové poznatky
- DeepWiki (
https://mcp.deepwiki.com/mcp) je hotový verejný MCP server pre dokumentáciu GitHub projektov - Môžeš si vytvoriť vlastné MCP servery na vystavenie nástrojov špecifických pre tvoju firmu
- Vlastný MCP server je webová aplikácia HTTPS, ktorá odpovedá na požiadavky objavovania a exekúcie
- Kombinácia verejných a interných serverov prináša najvýkonnejšie konfigurácie
- Každý server si udržuje vlastnú úroveň overovania a obmedzenia nástrojov