DeepWiki și instrumente personalizate
Pe această pagină
DeepWiki: Un server public pentru exerciții
Tot ce ați văzut până acum rămâne abstract până când conectați un server real. DeepWiki este candidatul ideal pentru acest prim test: expune un server MCP public la adresa https://mcp.deepwiki.com/mcp, fără autentificare, care oferă acces la documentația oricărui proiect GitHub.
Configurarea necesită doar câteva linii, deoarece singurul parametru opțional care contează cu adevărat aici este descrierea.
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."
)
]
Odată stabilită această conexiune, puneți-i lui Grok întrebări care necesită în mod real citirea repository-ului: „explică cum funcționează rutarea în proiectul facebook/react“, „care sunt opțiunile de configurare pentru vercel/next.js?“ sau „arată-mi structura proiectului pentru langchain-ai/langchain“. Modelul apelează instrumentele DeepWiki, preia documentația și codul sursă, apoi sintetizează un răspuns structurat. Comparați acest răspuns cu ceea ce ați obține fără serverul MCP: diferența dintre ceea ce știe modelul și ceea ce tocmai a citit devine imediat evidentă.
Trecerea la propriile servere
DeepWiki este un teren de antrenament excelent, dar valoarea reală a MCP apare atunci când serverul expune ceea ce nimeni altcineva nu poate: datele dumneavoastră, procesele dumneavoastră, instrumentele dumneavoastră de afaceri.
Din punct de vedere tehnic, un server MCP este o aplicație web care răspunde la două tipuri de cereri. Mai întâi, descoperirea: când Grok se conectează, solicită lista instrumentelor disponibile împreună cu schemele lor. Apoi, execuția: când modelul decide să apeleze un instrument, transmite numele instrumentului și argumentele sale, apoi așteaptă rezultatul. Serverul trebuie să expună un endpoint HTTPS conform protocolului MCP, folosind Streaming HTTP sau SSE – cele două transporturi acoperite la începutul cursului.
Ceea ce face un server personalizat interesant nu este tehnica, ci alegerea instrumentelor pe care le publică. Iată trei exemple de separare coerentă, în care fiecare server acoperă un singur domeniu și doar unul:
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
Această separare pe domenii nu este doar de fațadă: vă permite să ierarhizați autentificarea și restricțiile serverului per server, în loc să aplicați o singură regulă unui amestec eterogen de instrumente. Odată ce serverul dumneavoastră este implementat, conexiunea urmează exact modelul DeepWiki, completat cu token-ul și lista de允许 (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"]
)
]
Servere publice și interne în aceeași sesiune
Configurațiile devin cu adevărat interesante atunci când amestecați ambele familii, deoarece modelul poate corela apoi o sursă publică cu o sursă pe care doar dumneavoastră o dețineți.
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"]
),
]
Apoi, cereți-i lui Grok să compare documentația oficială React cu ghidul dumneavoastră intern de arhitectură privind rutarea: acesta interoghează DeepWiki pentru prima și serverul dumneavoastră de documentație pentru a doua, apoi contrastează cele două. Niciun model nu poate produce acest răspuns doar din cunoștințele sale proprii, iar nici căutarea pe web nu poate face acest lucru, deoarece jumătate din material există doar în compania dumneavoastră.
Observați în final cum sunt configurate diferit cele trei servere. Serverul public nu are nici token, nici listă de允许 (allowlist); documentația internă are un token, dar rămâne în mare parte deschisă deoarece este read-only; iar datele de afaceri combină token-ul cu o restricție strictă la trei operațiuni. Fiecare server poartă nivelul de control pe care conținutul său îl justifică – acesta este exact scopul separării lor.
Puncte cheie
- DeepWiki (
https://mcp.deepwiki.com/mcp) este un server MCP public, gata de utilizare, pentru documentația GitHub - Puteți crea propriile servere MCP pentru a expune instrumente specifice afacerii dumneavoastră
- Un server MCP personalizat este o aplicație web HTTPS care răspunde la cererile de descoperire și execuție
- Combinarea serverelor publice și interne oferă cele mai puternice configurații
- Fiecare server își menține propriul nivel de autentificare și restricționare a instrumentelor