DeepWiki u Għodod Personalizzati
F'din il-paġna
DeepWiki: Server Pubbliku għall-Prattika
Kollox ma rajt sa issa jibqa’ astratt sakemm ma tikkonnettjax ma’ server reali. DeepWiki huwa l-kandidat ideali għal dan l-ewwel test: jesponi server MCP pubbliku fuq https://mcp.deepwiki.com/mcp, mingħajr awtentikazzjoni, li jipprovdi aċċess għad-dokumentazzjoni ta’ kwalunkwe proġett fuq GitHub.
Il-konfigurazzjoni tieħu biss ftit linji, peress li l-uniku parametru fakultattiv li verament jimporthawn huwa d-deskrizzjoni.
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."
)
]
Ladarba din il-konnessjoni tiġi stabbilita, staqsi mistoqsijiet lil Grok li fil-fatt jeħtieġu l-qari tar-repożitorju: “spjega kif taħdem ir-routing fil-proġett facebook/react”, “x’inhuma l-għażliet ta’ konfigurazzjoni għal vercel/next.js?”, jew “urini l-istruttura tal-proġett għal langchain-ai/langchain”. Il-mudell isejjaħ l-għodod ta’ DeepWiki, jirkupra d-dokumentazzjoni u l-kodiċi sors, imbagħad jissintetizza tweġiba strutturata. Qabbel din it-tweġiba ma’ dak li kieku tikseb mingħajr is-server MCP: id-differenza bejn dak li l-mudell jaf u dak li għadu kemm qara hija ovvja immedjatament.
Nimxu lejn is-Servers Tiegħek Stess
DeepWiki huwa post eċċellenti għat-taħriġ, iżda l-valur reali ta’ MCP jidher meta s-server jesponi dak li ħadd ieħor ma jista’: id-data tiegħek, il-proċessi tiegħek, l-għodod tan-negozju tiegħek.
Teknikament, server MCP huwa applikazzjoni web li tirrispondi għal żewġ tipi ta’ talbiet. L-ewwel, l-iskoperta: meta Grok jikkonnettja, jitlob il-lista tal-għodod disponibbli flimkien mal-iskemi tagħhom. Imbagħad, l-eżekuzzjoni: meta l-mudell jiddeċiedi li jsejjaħ għodda, jittrażmetti l-isem tal-għodda u l-argumenti tagħha, imbagħad jistenna r-riżultat. Is-server irid jesponi endpoint HTTPS konformi mal-protokoll MCP, billi juża Streaming HTTP jew SSE—iż-żewġ trasporti koperti fil-bidu tal-kors.
Dak li jagħmel server personalizzat interessanti mhux it-teknika, iżda l-għażla tal-għodod li jippubblika. Hawnhekk huma tliet eżempji ta’ qsim koerenti, fejn kull server ikopri dominju wieħed u wieħed biss:
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
Dan il-qsim tad-dominji mhuwiex biss għad-dehra: jippermettilek li tgradwa l-awtentikazzjoni u r-restrizzjonijiet tas-server għal kull server, minflok ma tapplika regola waħda għal taħlita ta’ għodod eteroġenji. Ladarba s-server tiegħek jiġi dispjegat, il-konnessjoni ssegwi eżattament il-mudell ta’ DeepWiki, miżjuda bit-token u l-lista tal-permessi (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"]
)
]
Servers Pubbliċi u Interni fl-Istess Sessjoni
Il-konfigurazzjonijiet isiru verament interessanti meta tħallat iż-żewġ familji, għax allura l-mudell jista’ jikkorrelata sors pubbliku ma’ sors li għandek int biss.
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"]
),
]
Imbagħad itlob lil Grok iqabbel id-dokumentazzjoni uffiċjali ta’ React mal-gwida tal-arkitettura interna tiegħek dwar ir-routing: huwa jistaqsi lil DeepWiki għall-ewwel u lis-server tad-dokumentazzjoni tiegħek għat-tieni, imbagħad iqabbel iż-żewġ partijiet. L-ebda mudell ma jista’ jipproduċi din it-tweġiba mill-għarfien tiegħu stess biss, u lanqas it-tiftix fuq il-web, peress li nofs il-materjal jeżisti biss fil-kumpanija tiegħek.
Innota finalment kif it-tliet servers huma kkonfigurati b’mod differenti. Is-server pubbliku m’għandux la token u lanqas lista ta’ permessi, id-dokumentazzjoni interna għandha token iżda tibqa’ miftuħa ħafna għax hija biss għall-qari, u d-data tan-negozju tgħaqqad it-token ma’ restrizzjoni stretta għal tliet operazzjonijiet biss. Kull server iġorr il-livell ta’ kontroll li l-kontenut tiegħu jiġġustifika—dan huwa eżattament il-punt tas-separazzjoni tagħhom.
Punti Ewlenin
- DeepWiki (
https://mcp.deepwiki.com/mcp) huwa server MCP pubbliku lest għall-użu għad-dokumentazzjoni ta’ GitHub - Tista’ toħloq is-servers MCP tiegħek stess biex tesponi għodod speċifiċi għan-negozju tiegħek
- Server MCP personalizzat huwa applikazzjoni web HTTPS li tirrispondi għal talbiet ta’ skoperta u eżekuzzjoni
- Il-kombinazzjoni ta’ servers pubbliċi u interni tipproduċi l-aktar konfigurazzjonijiet qawwija
- Kull server iżomm il-livell tiegħu stess ta’ awtentikazzjoni u restrizzjoni tal-għodod