DeepWiki и персонализирани инструменти
На тази страница
DeepWiki: Публичен сървър за упражнения
Всичко, което видяхте досега, остава абстрактно, докато не свържете реален сървър. DeepWiki е идеалният кандидат за този първи тест: той предоставя публичен MCP сървър на адрес https://mcp.deepwiki.com/mcp, без нужда от удостоверяване, който осигурява достъп до документацията на всеки проект в GitHub.
Конфигурацията изисква само няколко реда код, тъй като единственият важен незадължителен параметър тук е описанието.
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."
)
]
След установяване на тази връзка, задайте на Grok въпроси, които изискват реално прочитане на хранилището: „обяснете как работи маршрутизирането в проекта facebook/react“, „какви са опциите за конфигурация на vercel/next.js?“ или „покажете ми структурата на проекта langchain-ai/langchain“. Моделът извиква инструментите на DeepWiki, извлича документацията и изходния код, след което синтезира структуриран отговор. Сравнете този отговор с този, който бихте получили без MCP сървъра: разликата между знанията на модела и информацията, която току-що е прочел, е веднага очевидна.
Преминаване към собствени сървъри
DeepWiki е отлична тренировъчна площадка, но истинската стойност на MCP се проявява, когато сървърът излага нещо, до което никой друг няма достъп: вашите данни, вашите процеси, вашите бизнес инструменти.
Технически погледнато, MCP сървърът е уеб приложение, което отговаря на два типа заявки. Първо, откриване: когато Grok се свърже, той иска списък с наличните инструменти заедно с техните схеми. Второ, изпълнение: когато моделът реши да извика инструмент, той предава името на инструмента и неговите аргументи, след което изчаква резултата. Сървърът трябва да излага HTTPS крайна точка, съвместима с протокола MCP, използвайки Streaming HTTP или SSE – двата транспорта, разгледани в началото на курса.
Това, което прави един персонализиран сървър интересен, не е техниката, а изборът на инструменти, които той публикува. Ето три примера за логическо разделяне, при което всеки сървър покрива една и само една област:
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
Това разделяне по области не е просто за показ: то Ви позволява да йерархизирате удостоверяването и ограниченията на сървъра за всеки отделен сървър, вместо да прилагате едно общо правило към смесена група от хетерогенни инструменти. След като Вашият сървър бъде внедрен, свързването следва точно модела на DeepWiki, допълнен с токен и списък с позволени инструменти (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"]
)
]
Публични и вътрешни сървъри в една и съща сесия
Конфигурациите стават наистина интересни, когато смесите двете семейства, защото тогава моделът може да корелира публичен източник с източник, достъпен само за Вас.
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"]
),
]
След това поискайте от Grok да сравни официалната документация на React с Вашето вътрешно ръководство за архитектура относно маршрутизирането: той ще заявки DeepWiki за първото и Вашия документационен сървър за второто, след което ще противопостави двете. Никой модел не може да генерира този отговор единствено въз основа на собствените си знания, а уеб търсенето също не може, тъй като половината от материалите съществуват само във Вашата компания.
Обърнете внимание най-накрая как трите сървъра са конфигурирани по различен начин. Публичният сървър няма нито токен, нито списък с позволени инструменти; вътрешната документация има токен, но остава до голяма степен отворена, защото е само за четене; а бизнес данните комбинират токен със строго ограничение до три операции. Всеки сървър носи нивото на контрол, което съдържанието му оправдава – това е точно смисълът на тяхното разделяне.
Ключови изводи
- DeepWiki (
https://mcp.deepwiki.com/mcp) е готов за употреба публичен MCP сървър за документация на GitHub - Можете да създадете свои собствени MCP сървъри, за да изложите инструменти, специфични за Вашия бизнес
- Персонализираният MCP сървър е HTTPS уеб приложение, което отговаря на заявки за откриване и изпълнение
- Комбинирането на публични и вътрешни сървъри води до най-мощните конфигурации
- Всеки сървър поддържа собственото си ниво на удостоверяване и ограничение на инструментите