Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

DeepWiki u Għodod Personalizzati

Lezzjoni 9 / 12 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. DeepWiki: Server Pubbliku għall-Prattika
  2. Nimxu lejn is-Servers Tiegħek Stess
  3. Servers Pubbliċi u Interni fl-Istess Sessjoni
  4. Punti Ewlenin

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