DeepWiki és egyedi eszközök
Ezen az oldalon
DeepWiki: Nyilvános szerver gyakorláshoz
Mindaz, amit eddig láttál, elvont marad, amíg nem csatlakoztatsz egy valódi szervert. A DeepWiki ideális jelölt erre az első tesztre: egy nyilvános MCP szervert tesz közzé a https://mcp.deepwiki.com/mcp címen, hitelesítés nélkül, amely hozzáférést biztosít bármely GitHub-projekt dokumentációjához.
A konfiguráció mindössze néhány sorból áll, mivel az egyetlen igazán fontos opcionális paraméter itt a leírás.
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."
)
]
Ha ez a kapcsolat létrejött, tegyél fel Groknak olyan kérdéseket, amelyek ténylegesen megkövetelik a tároló (repository) olvasását: „magyarázd el, hogyan működik az útválasztás a facebook/react projektben“, „mik a vercel/next.js konfigurációs lehetőségei?“, vagy „mutasd meg a langchain-ai/langchain projektfelépítését“. A modell meghívja a DeepWiki eszközöket, lekéri a dokumentációt és a forráskódot, majd szintetizál egy strukturált választ. Hasonlítsd össze ezt a választ azzal, amit MCP szerver nélkül kapnál: a különbség a modell tudása és az imént olvasott információ között azonnal nyilvánvalóvá válik.
Áttérés a saját szervereidre
A DeepWiki kiváló gyakorlóterep, de az MCP igazi értéke akkor mutatkozik meg, amikor a szerver olyat tesz elérhetővé, ami másnak nem: a te adataidat, folyamataidat, üzleti eszközeidet.
Technikai értelemben az MCP szerver egy webes alkalmazás, amely kétféle kérésre válaszol. Először a felfedezés (discovery): amikor a Grok csatlakozik, lekéri az elérhető eszközök listáját a sémáikkal együtt. Ezután a végrehajtás: amikor a modell úgy dönt, hogy meghív egy eszközt, elküldi az eszköz nevét és argumentumait, majd várja az eredményt. A szervernek egy, az MCP protokollnak megfelelő HTTPS végpontot kell közzétennie, Streaming HTTP vagy SSE használatával – ez a két transzportprotokoll volt a tanfolyam elején tárgyalva.
Egy egyedi szervert nem a technika, hanem a közzétett eszközök választéka tesz érdekessé. Íme három példa a koherens szétválasztásra, ahol minden szerver egyetlen, és csak is egyetlen domaint fed le:
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
Ez a domainek szerinti szétválasztás nem csak a látvány kedvéért van: lehetővé teszi, hogy szerverenként eltérő hitelesítési szinteket és korlátozásokat alkalmazz, ahelyett, hogy egyetlen szabályt kényszerítenél rá vegyes, heterogén eszközök halmazára. Miután a szervered üzembe helyezted, a csatlakozás pontosan követi a DeepWiki mintáját, kiegészítve a tokennel és az engedélyezési listával (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"]
)
]
Nyilvános és belső szerverek ugyanabban a munkamenetben
A konfigurációk akkor válnak igazán érdekessé, amikor mindkét típust vegyíted, mert így a modell korrelálni tudja a nyilvános forrásokat a kizárólag számodra elérhető forrásokkal.
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"]
),
]
Ezután kérd meg Grokot, hogy hasonlítsa össze a hivatalos React dokumentációt a saját, útválasztással foglalkozó belső architektúra-útmutatóddal: az elsőhöz a DeepWikiből kérdez, a másodikhoz a saját dokumentációs szerveredből, majd szembeállítja a kettőt. Egyetlen modell sem képes ilyen választ előállítani kizárólag a saját tudása alapján, és a webes keresés sem, mivel az anyag fele csak a te cégednél létezik.
Végül vedd észre, hogyan konfiguráltad eltérően a három szervert. A nyilvános szervernek nincs tokenje sem engedélyezési listája, a belső dokumentációnak van tokenje, de nagyrészt nyitott marad, mivel csak olvasható, az üzleti adatok szervere pedig kombinálja a tokent a szigorú korlátozással, csupán három műveletre. Minden szerver annyira szigorú ellenőrzést hordoz, amennyit a tartalma indokol – pontosan ez a lényege a szétválasztásuknak.
Főbb megállapítások
- A DeepWiki (
https://mcp.deepwiki.com/mcp) egy használatra kész, nyilvános MCP szerver GitHub-dokumentációhoz - Létrehozhatsz saját MCP szervereket, hogy a vállalkozásodra jellemző eszközöket tegyél elérhetővé
- Az egyedi MCP szerver egy HTTPS webes alkalmazás, amely válaszol a felfedezési és végrehajtási kérésekre
- A nyilvános és belső szerverek kombinációja adja a leghatékonyabb konfigurációkat
- Minden szerver fenntartja a saját hitelesítési szintjét és eszközkorlátozásait