Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

DeepWiki a vlastní nástroje

Lekce 9 z 12 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. DeepWiki: Veřejný server pro procvičování
  2. Přechod na vlastní servery
  3. Veřejné a interní servery ve stejné relaci
  4. Klíčové poznatky

DeepWiki: Veřejný server pro procvičování

Vše, co jsi doposud viděl, zůstává abstraktní, dokud se nepřipojíš ke skutečnému serveru. DeepWiki je ideálním kandidátem pro tento první test: zpřístupňuje veřejný MCP server na adrese https://mcp.deepwiki.com/mcp bez nutnosti autentizace, který poskytuje přístup k dokumentaci jakéhokoli projektu na GitHubu.

Konfigurace zabere jen několik řádků, protože jediným volitelným parametrem, na kterém zde skutečně 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."
    )
]

Jakmile je toto připojení navázáno, můžeš se Groka ptát na otázky, které skutečně vyžadují čtení repozitáře: „vysvětli, jak funguje směrování v projektu facebook/react“, „jaké jsou možnosti konfigurace pro vercel/next.js?“ nebo „ukaž mi strukturu projektu langchain-ai/langchain“. Model zavolá nástroje DeepWiki, získá dokumentaci a zdrojový kód a následně syntetizuje strukturovanou odpověď. Porovnej tuto odpověď s tím, co bys získal bez MCP serveru: rozdíl mezi tím, co model ví, a tím, co právě přečetl, je okamžitě zřejmý.

Přechod na vlastní servery

DeepWiki je vynikajícím cvičným polygonem, ale skutečná hodnota MCP se projeví, když server zpřístupní to, co nikdo jiný nemůže: tvá data, tvé procesy, tvé obchodní nástroje.

Technicky vzato je server MCP webová aplikace, která odpovídá na dva typy požadavků. Nejprve objevování: když se Grok připojí, vyžádá si seznam dostupných nástrojů včetně jejich schémat. Následuje provedení: když se model rozhodne nástroj zavolat, přenese název nástroje a jeho argumenty a poté čeká na výsledek. Server musí vystavovat koncový bod HTTPS v souladu s protokolem MCP s využitím Streaming HTTP nebo SSE – dvou transportních mechanismů, které jsme probírali na začátku kurzu.

To, co dělá vlastní server zajímavým, není technika, ale výběr nástrojů, které publikuje. Zde jsou tři příklady soudržného rozdělení, kde každý server pokrývá jednu a pouze jednu doménu:

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

Toto rozdělení podle domén není jen pro show: umožňuje ti nastavit úrovně autentizace a omezení serveru pro každý server zvlášť, místo abys aplikoval jedno pravidlo na směsici heterogenních nástrojů. Jakmile je tvůj server nasazen, připojení probíhá přesně podle vzoru DeepWiki, rozšířeného o token a seznam povolených nástrojů (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"]
    )
]

Veřejné a interní servery ve stejné relaci

Konfigurace se stávají skutečně zajímavými, když zkombinuješ obě rodiny, protože model pak může korelovat veřejný zdroj se zdrojem, který máš pouze 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"]
    ),
]

Poté požádej Groka, aby porovnal oficiální dokumentaci Reactu s tvým interním architektonickým průvodcem týkajícím se směrování: pro první část se dotáže DeepWiki a pro druhou tvého dokumentačního serveru, následně obě strany kontrastuje. Žádný model nedokáže tuto odpověď vytvořit pouze na základě svých vlastních znalostí a totéž platí pro webové vyhledávání, protože polovina materiálů existuje pouze ve tvé společnosti.

Všimni si konečně, jak jsou tři servery konfigurovány odlišně. Veřejný server nemá ani token, ani seznam povolených nástrojů; interní dokumentace má token, ale zůstává z velké části otevřená, protože je určena pouze pro čtení; a obchodní data kombinují token s přísným omezením na tři operace. Každý server nese úroveň kontroly, kterou jeho obsah ospravedlňuje – přesně v tom spočívá smysl jejich oddělení.

Klíčové poznatky

  • DeepWiki (https://mcp.deepwiki.com/mcp) je veřejný MCP server připravený k použití pro dokumentaci GitHubu
  • Můžeš si vytvořit vlastní servery MCP pro zpřístupnění nástrojů specifických pro tvůj byznys
  • Vlastní server MCP je webová aplikace přes HTTPS, která odpovídá na požadavky objevování a provedení
  • Kombinace veřejných a interních serverů přináší nejmocnější konfigurace
  • Každý server si udržuje vlastní úroveň autentizace a omezení nástrojů