DeepWiki en aangepaste tools
Op deze pagina
DeepWiki: een openbare server om mee te oefenen
Alles wat u tot nu toe heeft gezien, blijft abstract totdat u verbinding maakt met een echte server. DeepWiki is de ideale kandidaat voor deze eerste test: het biedt een openbare MCP-server aan op https://mcp.deepwiki.com/mcp, zonder authenticatie, die toegang geeft tot documentatie voor elk GitHub-project.
De configuratie vereist slechts een paar regels, aangezien de enige optionele parameter die hier echt toe doet, de beschrijving is.
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."
)
]
Zodra deze verbinding tot stand is gebracht, kunt u Grok vragen stellen die daadwerkelijk het lezen van de repository vereisen: “leg uit hoe routing werkt in het facebook/react-project”, “wat zijn de configuratieopties voor vercel/next.js?” of “toon mij de projectstructuur voor langchain-ai/langchain”. Het model roept de DeepWiki-tools aan, haalt documentatie en broncode op en synthetiseert vervolgens een gestructureerd antwoord. Vergelijk dit antwoord met wat u zou krijgen zonder de MCP-server: het verschil tussen wat het model weet en wat het zojuist heeft gelezen, is direct duidelijk.
De overstap naar uw eigen servers
DeepWiki is een uitstekende oefenomgeving, maar de echte waarde van MCP komt naar voren wanneer de server iets blootlegt dat niemand anders heeft: uw data, uw processen, uw bedrijfsmiddelen.
Technisch gezien is een MCP-server een webapplicatie die reageert op twee soorten verzoeken. Eerst ontdekking: wanneer Grok verbinding maakt, vraagt het om de lijst met beschikbare tools inclusief hun schema’s. Daarna uitvoering: wanneer het model besluit een tool aan te roepen, verzendt het de naam van de tool en de bijbehorende argumenten, en wacht het op het resultaat. De server moet een HTTPS-eindpunt beschikbaar stellen dat conform is aan het MCP-protocol, met gebruik van Streaming HTTP of SSE – de twee transportmethoden die aan het begin van de cursus aan bod zijn gekomen.
Wat een aangepaste server interessant maakt, is niet de techniek, maar de keuze van de tools die het publiceert. Hier zijn drie voorbeelden van een coherente opsplitsing, waarbij elke server één domein bestrijkt en slechts één:
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
Deze domeinopsplitsing is niet louter voor de show: het stelt u in staat authenticatie en serverbeperkingen per server te differentiëren, in plaats van één enkele regel toe te passen op een gemengde verzameling heterogene tools. Zodra uw server is geïmplementeerd, volgt de verbinding exact hetzelfde patroon als bij DeepWiki, aangevuld met het token en de toegestane lijst (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"]
)
]
Openbare en interne servers in dezelfde sessie
Configuraties worden pas echt interessant wanneer u beide families combineert, omdat het model dan een openbare bron kan correleren met een bron die alleen u heeft.
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"]
),
]
Vraag Grok vervolgens om de officiële React-documentatie te vergelijken met uw interne architectuurgids over routing: het vraagt DeepWiki om het eerste en uw documentatieserver om het tweede, en zet de twee vervolgens tegenover elkaar. Geen enkel model kan dit antwoord produceren op basis van zijn eigen kennis alleen, en webzoekopdrachten kunnen dit ook niet, aangezien de helft van het materiaal alleen binnen uw bedrijf bestaat.
Merk tot slot op hoe de drie servers verschillend zijn geconfigureerd. De openbare server heeft geen token noch toegestane lijst, de interne documentatie heeft wel een token maar blijft grotendeels open omdat deze alleen-lezen is, en de bedrijfsdata combineert een token met een strikte beperking tot drie bewerkingen. Elke server draagt het controle niveau dat de inhoud rechtvaardigt – dat is precies het doel van het scheiden ervan.
Belangrijkste punten
- DeepWiki (
https://mcp.deepwiki.com/mcp) is een kant-en-klare openbare MCP-server voor GitHub-documentatie - U kunt uw eigen MCP-servers maken om tools specifiek voor uw bedrijf beschikbaar te stellen
- Een aangepaste MCP-server is een HTTPS-webapplicatie die reageert op ontdekking- en uitvoeringsverzoeken
- Het combineren van openbare en interne servers levert de krachtigste configuraties op
- Elke server handhaaft zijn eigen niveau van authenticatie en tool-beperking