DeepWiki un rīki pēc pasūtījuma
Šajā lapā
DeepWiki: Publisks serveris praksei
Viss, ko esi redzējis līdz šim, paliek abstrakts, kamēr nepievieno reālu serveri. DeepWiki ir ideāls kandidāts šim pirmajam testam: tas piedāvā publisku MCP serveri adresē https://mcp.deepwiki.com/mcp bez autentifikācijas, nodrošinot piekļuvi jebkura GitHub projekta dokumentācijai.
Konfigurācija aizņem tikai dažas rindiņas, jo vienīgais obligātais parametrs, kam šeit ir nozīme, ir apraksts.
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."
)
]
Kad savienojums ir izveidots, uzdod Grok jautājumus, kuriem faktiski nepieciešams lasīt repozitoriju: „paskaidro, kā maršrutēšana darbojas facebook/react projektā”, „kādas ir vercel/next.js konfigurācijas opcijas?” vai „parādi langchain-ai/langchain projekta struktūru”. Modelis izsauc DeepWiki rīkus, iegūst dokumentāciju un pirmkodu, pēc tam sintetizē strukturētu atbildi. Salīdzini šo atbildi ar to, ko saņemtu bez MCP servera: atšķirība starp modeļa zināšanām un to, ko tas tikko izlasījis, ir acumirklī acīmredzama.
Pāreja uz saviem serveriem
DeepWiki ir lielisks treniņlaukums, taču MCP patiesā vērtība atklājas, kad serveris dara pieejamu to, kas nav pieejams nevienam citam: tavus datus, tavus procesus, tavus biznesa rīkus.
Techniski MCP serveris ir tīmekļa lietotne, kas reaģē uz divu veidu pieprasījumiem. Vispirms atklāšana: kad Grok pieslēdzas, tas pieprasa pieejamo rīku sarakstu kopā ar to shēmām. Tad izpilde: kad modelis nolemj izsaukt rīku, tas nosūta rīka nosaukumu un tā argumentus, pēc tam gaida rezultātu. Serverim ir jāeksponē HTTPS galapunkts, kas atbilst MCP protokolam, izmantojot Streaming HTTP vai SSE — abus pārraides veidus apskatījām kursa sākumā.
To, kas padara serveri pēc pasūtījuma interesantu, nav tehnika, bet gan publicēto rīku izvēle. Lūk, trīs piemēri loģiskai sadalīšanai, kur katrs serveris aptver vienu un tikai vienu domēnu:
Serveris "analytics":
- get_dashboard_metrics: informācijas paneļa metrikas
- query_events: analītisko notikumu vaicājumi
- get_funnel_report: konversijas piltuves ziņojums
Serveris "content":
- search_articles: meklēšana CMS sistēmā
- get_article: pilna raksta iegūšana
- list_categories: satura kategoriju saraksts
Serveris "devops":
- get_deploy_status: pēdējās izvietošanas statuss
- list_alerts: aktīvie monitoringa brīdinājumi
- get_service_health: konkrēta servisa veselības stāvoklis
Šī sadalīšana pa domēniem nav tikai skaistumam: tā ļauj ieviest daudzpakāpju autentifikāciju un servera ierobežojumus katram serverim atsevišķi, nevis piemērot vienu noteikumu jauktam heterogēnu rīku kopumam. Kad tavs serveris ir izvietots, savienojuma izveide precīzi atkārto DeepWiki paraugu, papildinot to ar pilnvaru un atļauto rīku sarakstu.
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"]
)
]
Publiski un iekšēji serveri vienā sesijā
Konfigurācijas kļūst patiesi interesantas, ja sajauc abas ģimenes, jo tad modelis var korelēt publisku avotu ar avotu, kas ir tikai tev.
tools = [
# Publisks serveris atvērtā pirmkoda dokumentācijai
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentation for open-source GitHub projects"
),
# Iekšējs serveris produkta dokumentācijai
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')}"
),
# Iekšējs serveris biznesa datiem
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"]
),
]
Tad lūdz Grok salīdzināt oficiālo React dokumentāciju ar tavu iekšējo arhitektūras ceļvedi par maršrutēšanu: tas vaicā DeepWiki pirmo un tavam dokumentācijas serverim otro, pēc tam salīdzina abus. Neviens modelis nevar ģenerēt šādu atbildi, balstoties tikai uz savām zināšanām, to nevar arī tīmekļa meklēšana, jo puse materiālu eksistē tikai tavā uzņēmumā.
Visbeidzot, ievēro, kā trīs serveri ir konfigurēti atšķirīgi. Publiskajam serverim nav nedz pilnvaras, nedz atļauto rīku saraksta; iekšējai dokumentācijai ir pilnvara, taču tā paliek plaši atvērta, jo ir tikai lasāma; biznesa dati apvieno pilnvaru ar stingru ierobežojumu līdz trim operācijām. Katrs serveris nes kontroles līmeni, ko attaisno tā saturs — tieši tāpēc ir jēga tos atdalīt.
Galvenās atziņas
- DeepWiki (
https://mcp.deepwiki.com/mcp) ir gatavs lietošanai publisks MCP serveris GitHub dokumentācijai - Tu vari izveidot savus MCP serverus, lai eksponētu rīkus, kas specifiski tavam biznesam
- MCP serveris pēc pasūtījuma ir HTTPS tīmekļa lietotne, kas reaģē uz atklāšanas un izpildes pieprasījumiem
- Publisku un iekšēju serveru kombinēšana rada visspēcīgākās konfigurācijas
- Katrs serveris uztur savu autentifikācijas līmeni un rīku ierobežojumus