Przejdź do głównej treści
Polski— Wybierz język
Menu

DeepWiki i narzędzia niestandardowe

Lekcja 9 z 12 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. DeepWiki: publiczny serwer do ćwiczeń
  2. Przejście do własnych serwerów
  3. Serwery publiczne i wewnętrzne w tej samej sesji
  4. Kluczowe wnioski

DeepWiki: publiczny serwer do ćwiczeń

Wszystko, co widziałeś do tej pory, pozostaje abstrakcyjne, dopóki nie podłączysz rzeczywistego serwera. DeepWiki to idealny kandydat na pierwszy test: udostępnia publiczny serwer MCP pod adresem https://mcp.deepwiki.com/mcp, bez uwierzytelniania, który zapewnia dostęp do dokumentacji dowolnego projektu na GitHubie.

Konfiguracja zajmuje zaledwie kilka linii, ponieważ jedynym opcjonalnym parametrem, który ma tutaj znaczenie, jest opis.

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."
    )
]

Gdy połączenie zostanie nawiązane, zadawaj Grokowi pytania, które faktycznie wymagają przeczytania repozytorium: „wyjaśnij, jak działa routing w projekcie facebook/react“, „jakie są opcje konfiguracji dla vercel/next.js?“ lub „pokaż mi strukturę projektu langchain-ai/langchain“. Model wywołuje narzędzia DeepWiki, pobiera dokumentację i kod źródłowy, a następnie syntezuje ustrukturyzowaną odpowiedź. Porównaj tę odpowiedź z tym, co otrzymałbyś bez serwera MCP: różnica między wiedzą modelu a tym, co właśnie przeczytał, jest natychmiast oczywista.

Przejście do własnych serwerów

DeepWiki to doskonały poligon doświadczalny, ale prawdziwa wartość MCP ujawnia się, gdy serwer udostępnia to, do czego nikt inny nie ma dostępu: Twoje dane, Twoje procesy, Twoje narzędzia biznesowe.

Technicznie serwer MCP to aplikacja internetowa odpowiadająca na dwa rodzaje żądań. Najpierw odkrywanie: gdy Grok się łączy, żąda listy dostępnych narzędzi wraz z ich schematami. Następnie wykonanie: gdy model zdecyduje się wywołać narzędzie, przesyła jego nazwę i argumenty, a następnie czeka na wynik. Serwer musi udostępniać punkt końcowy HTTPS zgodny z protokołem MCP, używając Streaming HTTP lub SSE – dwóch transportów omówionych na początku kursu.

O tym, czy niestandardowy serwer jest interesujący, nie decyduje technika, lecz wybór narzędzi, które publikuje. Oto trzy przykłady spójnego podziału, gdzie każdy serwer obejmuje jedną i tylko jedną domenę:

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

Ten podział na domeny nie jest tylko dla pokazówki: pozwala na wielopoziomowe uwierzytelnianie i ograniczenia serwera dla każdego z nich osobno, zamiast stosowania jednej reguły do mieszanki niejednorodnych narzędzi. Po wdrożeniu serwera połączenie przebiega dokładnie według wzorca DeepWiki, uzupełnionego o token i listę dozwolonych narzędzi (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"]
    )
]

Serwery publiczne i wewnętrzne w tej samej sesji

Konfiguracje stają się naprawdę interesujące, gdy łączysz obie rodziny, ponieważ model może wtedy skorelować źródło publiczne ze źródłem dostępnym tylko dla Ciebie.

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"]
    ),
]

Następnie poproś Groka o porównanie oficjalnej dokumentacji React z Twoim wewnętrznym przewodnikiem po architekturze dotyczącym routingu: queried DeepWiki dla pierwszego i Twój serwer dokumentacji dla drugiego, a następnie zestawi oba wyniki. Żaden model nie jest w stanie wygenerować takiej odpowiedzi wyłącznie na podstawie własnej wiedzy, nie potrafi tego również wyszukiwarka internetowa, ponieważ połowa materiałów istnieje tylko w Twojej firmie.

Zauważ na koniec, jak trzy serwery są skonfigurowane inaczej. Serwer publiczny nie ma ani tokena, ani listy dozwolonych narzędzi, wewnętrzna dokumentacja posiada token, ale pozostaje w dużej mierze otwarta, ponieważ jest tylko do odczytu, a dane biznesowe łączą token ze ścisłym ograniczeniem do trzech operacji. Każdy serwer niesie ze sobą poziom kontroli, na jaki zasługuje jego zawartość – to właśnie jest sens ich rozdzielania.

Kluczowe wnioski

  • DeepWiki (https://mcp.deepwiki.com/mcp) to gotowy do użycia publiczny serwer MCP z dokumentacją GitHub
  • Możesz tworzyć własne serwery MCP, aby udostępniać narzędzia specyficzne dla Twojego biznesu
  • Niestandardowy serwer MCP to aplikacja internetowa HTTPS odpowiadająca na żądania odkrywania i wykonania
  • Łączenie serwerów publicznych i wewnętrznych daje najpotężniejsze konfiguracje
  • Każdy serwer utrzymuje własny poziom uwierzytelniania i ograniczeń narzędzi