Sdílet prostřednictvím


Použití serverů MCP

Model Context Protocol (MCP) je otevřený standard, který umožňuje modelům AI pracovat s externími nástroji a službami prostřednictvím sjednoceného rozhraní. Podpora MCP v sadě Visual Studio vylepšuje režim agenta GitHub Copilot tím, že umožňuje připojit jakýkoli server kompatibilní s MCP k pracovnímu postupu kódování agenta.

Tento článek vás provede nastavením serverů MCP a používáním nástrojů s režimem agenta v sadě Visual Studio.

Požadavky

  • Visual Studio 2022 verze 17.14 nebo novější Důrazně doporučujeme nejnovější servisní verzi 17.14, protože každá verze přidává funkce MCP.

Jak MCP a Visual Studio rozšiřují agenta GitHub Copilot

Podpora MCP v sadě Visual Studio funguje takto:

  • Klienti MCP, jako je Visual Studio, se připojují k serverům MCP a požadují akce jménem modelu AI.
  • Servery MCP poskytují jeden nebo více nástrojů, které zpřístupňují konkrétní funkce prostřednictvím dobře definovaného rozhraní.
  • Protokol definuje formát zprávy pro komunikaci mezi klienty a servery, včetně zjišťování nástrojů, vyvolání a zpracování odpovědí.

Například server MCP pro systém souborů může poskytovat nástroje pro čtení, zápis nebo vyhledávání souborů a adresářů. Oficiální server MCP GitHubu nabízí nástroje pro výpis úložišť, vytváření žádostí o přijetí změn nebo správu problémů. Servery MCP se můžou spouštět místně na vašem počítači nebo vzdáleně hostovat. Visual Studio podporuje obě konfigurace.

Díky standardizaci této interakce MCP eliminuje potřebu vlastních integrací mezi jednotlivými modely AI a jednotlivými nástroji. Možnosti asistenta AI pak můžete rozšířit jednoduše přidáním nových serverů MCP do pracovního prostoru. Přečtěte si další informace o specifikaci MCP.

Příklad konfigurace se serverem MCP GitHubu

Následující názorný postup vyžaduje verzi 17.14.9 nebo novější.

  1. Vytvořte nový soubor: <SOLUTIONDIR>\.mcp.json nebo %USERPROFILE%\.mcp.json. K úpravě tohoto souboru doporučujeme použít Visual Studio, aby se automaticky použilo jeho schéma JSON.

  2. Do souboru vložte následující obsah .mcp.json :

    {
      "servers": {
        "github": {
          "url": "https://api.githubcopilot.com/mcp/"
        }
      }
    }
    
  3. Uložte soubor. Potom aktivujte informace CodeLens, které se zobrazí na novém serveru, aby se ověřily na tomto serveru prostřednictvím účtu GitHubu.

  4. V sadě Visual Studio vyberte šipku Zeptat se v okně chatu GitHub Copilot a pak vyberte Agent.

    Snímek obrazovky znázorňující selektor režimu agenta Copilot

  5. Vyberte nástroje, které chcete použít; Například problémy se seznamem.

    Snímek obrazovky znázorňující nástroje GitHubu MCP

  6. Vyzkoušejte ukázkovou výzvu: Zobrazení seznamu problémů přiřazených mně na GitHubu

  7. Copilot žádá o povolení používat nástroj, který mu server MCP zpřístupnil. Vyberte Povolit pro rozsah, se kterým chcete pokračovat.

    Snímek obrazovky s možnostmi potvrzení pro nástroje agenta

Podporované možnosti MCP

Visual Studio podporuje následující funkce MCP:

  • Možnosti přenosu serveru MCP jsou místní standardní vstup/výstup (stdio), události odesílané serverem (sse) a streamovatelné HTTP (http).
  • Z funkcí (nástroje, výzvy, prostředky, vzorkování) teď Visual Studio podporuje:
    • Nástroje: Provádění akcí a operací prostřednictvím režimu agenta Copilot
    • Výzvy: Opakovaně použitelné šablony výzev, které můžete vyvolat pomocí parametrů
    • Prostředky: Přístup k externím datům a kontextu prostřednictvím prostředků založených na identifikátorech URI
    • Vzorkování: Vylepšené interakce modelu AI s vašimi nástroji a službami
  • Visual Studio poskytuje servery s aktuálními složkami řešení pomocí roots (specifikace).
  • Pro autorizaci MCP visual Studio podporuje ověřování pro vzdálené servery s libovolným poskytovatelem OAuth.

Vyhledání serverů MCP

Oficiální úložiště serverů MCP je skvělým výchozím bodem pro referenční, oficiální a komunitní servery, které ukazují všestrannost MCP. Servery můžete prozkoumat pro různé funkce, jako jsou operace systému souborů, interakce s databázemi a webové služby.

MCP je relativně nový standard a ekosystém se rychle vyvíjí. Vzhledem k tomu, že další vývojáři přijmou MCP, můžete očekávat, že uvidíte rostoucí počet serverů a nástrojů dostupných pro integraci s vašimi projekty.

Příklady serverů MCP

Vyzkoušejte si některé další oblíbené servery MCP v sadě Visual Studio jedním kliknutím:

  • Instalace programu Awesome MCP ve Visual Studio – Objevte a nainstalujte vlastní výzvy a návody pro GitHub Copilot.
  • Nainstalujte MarkItDown MCP v sadě Visual Studio – Převeďte různé formáty souborů (PDF, Word, Excel, obrázky, zvuk) na Markdown.
  • Nainstalujte DuckDB Server v sadě Visual Studio – dotazování a analýza dat v databázích DuckDB místně a v cloudu.
  • Nainstalujte MongoDB MCP v sadě Visual Studio – databázové operace a správa. Spouštět dotazy, spravovat kolekce, kanály agregace a operace dokumentů
  • Nainstalujte HuggingFace MCP v sadě Visual Studio – přístup k modelům, datovým sadám a Spaces na Hugging Face Hubu.

Možnosti přidání serveru MCP

V sadě Visual Studio máte několik možností, jak přidat server MCP.

Instalace z webu

S nejnovější servisní verzí verze 17.14 podporuje Visual Studio přímou instalaci serverů MCP. Můžete vybrat tlačítko Nainstalovat na serveru MCP a automaticky ho přidat do vaší instance sady Visual Studio.


Přidání tlačítka Instalovat pro server MCP
  1. Napište konfiguraci serveru MCP ve formátu JSON.

    Tady je příklad serveru HTTP/SSE:

    {"name":"My Server","type":"http","url":"https://example.com/mcp/"} 
    

    Tady je příklad serveru stdio:

    {"name":"My Server","type":"stdio","command":"python","args":["-m","my_mcp.server"]}
    

    Povinná pole jsou:

    Obor Description
    name Popisný název serveru
    type Typ připojení k serveru, například http nebo stdio
    url Adresa URL serveru vyžadovaná pro http
    command Příkaz pro spuštění spustitelného souboru serveru vyžadovaný pro stdio
    args Pole argumentů předaných příkazu, povinné pro stdio
  2. Zakódujte JSON pro použití v URL. Můžete použít online kodér nebo konzolu prohlížeče.

    Tady je příklad konzoly prohlížeče:

    encodeURIComponent('{"name":"My Server","type":"http","url":"https://example.com/mcp/"}')
    
  3. Vložte KÓD JSON kódovaný adresou URL do formátu URI MCP, který vytvoří odkaz pro instalaci sady Visual Studio. Použijte tento formát:

    vsweb+mcp:/install?<ENCODED_JSON>
    
  4. Přidejte odznáček Markdown do úložiště nebo dokumentů GitHubu. Například:

    [![Install MCP Server in Visual Studio](https://img.shields.io/badge/Install%20in%20Visual%20Studio-blue?logo=visualstudio)](vsweb+mcp:/install?<ENCODED_JSON>)
    

Když uživatel vybere odznáček, visual Studio se otevře (nebo vás vyzve k jeho otevření). Zobrazí se dialogové okno instalace MCP s předem vyplněnými podrobnostmi o serveru.


Přidat ze zobrazení chatu

Ve Visual Studio verze 17.14.13 nebo novější můžete přidat server MCP ze zobrazení chatu.

Přidání serveru MCP ze zobrazení chatu:

  1. V okně chatu vyberte zelené tlačítko plus (+) v nástroji.

    Snímek obrazovky s tlačítkem plus v nástroji pro výběr chatu v sadě Visual Studio pro přidání serveru MCP

  2. Zadejte název serveru a podrobnosti o připojení, například adresu URL pro servery HTTP nebo příkaz a argumenty pro servery stdio.

    Snímek obrazovky znázorňující přidání serveru MCP ze zobrazení chatu

Vytvoření souboru pro správu konfigurace serverů MCP

Pokud soubor ještě mcp.json nemáte, vytvořte ho v libovolném z podporovaných umístění na základě požadavků na úložiště, uživatele nebo editor.

Pokud chcete přidat server MCP, vyhledejte online konfiguraci JSON serveru. Najdete ho například v úložišti GitHub pro servery MCP. Pak vložte do souboru mcp.json.

Umístění souborů pro automatické zjišťování konfigurace MCP

Visual Studio také kontroluje konfigurace MCP, které nastavují jiná vývojová prostředí. Konfigurace serveru MCP se čtou z následujících adresářů v následujícím pořadí:

  1. %USERPROFILE%\.mcp.json
    Slouží jako globální konfigurace serveru MCP pro konkrétního uživatele. Přidáním serveru MCP zde se zajistí jeho načítání pro všechna řešení Visual Studio.
  2. <SOLUTIONDIR>\.vs\mcp.json
    Specifické pro Visual Studio a načte zadané servery MCP pouze pro konkrétního uživatele pro zadané řešení.
  3. <SOLUTIONDIR>\.mcp.json
    Funguje dobře, pokud hledáte konfiguraci MCP, kterou můžete sledovat ve správě zdrojového kódu pro úložiště.
  4. <SOLUTIONDIR>\.vscode\mcp.json
    Vymezený na úložiště nebo řešení a obvykle není řízen zdrojem.
  5. <SOLUTIONDIR>\.cursor\mcp.json
    Vymezený na úložiště nebo řešení a obvykle není řízen zdrojem.

Některá z těchto umístění vyžadují .mcp.json, zatímco jiné vyžadují mcp.json.

Formát konfigurace MCP

Můžete definovat vzdálené servery (adresy URL i přihlašovací údaje) i místní servery (vyvolání příkazového řádku).

Je běžné volat nástroje prostřednictvím správců balíčků; například npx -y @azure/mcp@latest nebo docker run ... mcp/github. Visual Studio respektuje jakýkoli zadaný příkaz, takže můžete podle potřeby připnout verze nebo předat příznaky.

Formát musí odpovídat specifikaci MCP. Musí například obsahovat pole serverových objektů, každý s name, command nebo url, a transport.

Úprava konfigurace MCP

Když máte existující mcp.json soubor, přidejte umístění souboru do položek řešení v Průzkumníku řešení, pokud soubor kontrolujete do systému správy verzí.

Při uložení souboru s platnou syntaxí se agent GitHub Copilot restartuje a znovu načte nakonfigurované servery.

Snímek obrazovky znázorňující přidání umístění konfiguračního souboru MCP do položek řešení

Životní cyklus nástrojů

Jakmile je server zjištěn nebo přidán:

  • Visual Studio inicializuje server provedením metody handshake a dotazováním seznamu nástrojů.
  • Visual Studio se přihlásí k odběru události notifications/tools/list_changed MCP.
  • Když se tato událost aktivuje, Visual Studio resetuje všechna předchozí přijetí nebo oprávnění k nástrojům (aby se zabránilo útokům rug-pull), znovu načte seznam nástrojů a živě aktualizuje počet a rozhraní.
  • Po úspěšném povolení serveru budou pro agenta k dispozici nástroje. Nástroje jsou ve výchozím nastavení zakázané a musí být povoleny ručně.
  • Pokud se server odebere, Visual Studio okamžitě zastaví proces a stáhne všechny jeho nástroje z uživatelského rozhraní.
  • Pokud upravíte definici serveru, Visual Studio ji ukončí a restartuje a pak se znovu dotazuje.

Správa schvalování nástrojů

Když je nástroj aktivován, Copilot požádá o potvrzení, že může nástroj spustit. Důvodem je, že nástroje můžou běžet místně na vašem počítači a provádět akce, které upravují soubory nebo data.

Po vyvolání nástroje v podokně chatu použijte možnosti rozevíracího seznamu Povolit . Můžete automaticky potvrdit konkrétní nástroj pro aktuální relaci, aktuální řešení nebo všechna budoucí vyvolání.

Snímek obrazovky znázorňující schválení nástrojů agenta

Výběry potvrzení nástroje můžete resetovat v podokně Možnosti>nástrojů, v části Všechna nastavení>GitHub>Copilot>Nástroje.

Snímek obrazovky znázorňující nastavení konfigurace nástrojů pro GitHub Copilot

Výběry potvrzení nástroje můžete obnovit v dialogovém okně Nástroje>Možnosti ve skupině Nástroje v části GitHub>Copilot.

Snímek obrazovky znázorňující nastavení konfigurace nástroje

Správa autorizace

Visual Studio teď podporuje ověřování pro vzdálené servery s libovolným poskytovatelem OAuth v souladu se specifikací autorizace MCP. Tato podpora je navíc součástí integrace se sadou Klíčů sady Visual Studio.

Správa ověřování pro server MCP:

  1. V souboru .mcp.json zvolte v CodeLens Spravovat ověřování pro tento server.

  2. V automaticky otevíraných dialogových oknech prohlížeče zadejte přihlašovací údaje potřebného zprostředkovatele OAuth pro daný server.

Výzvy a šablony výzev MCP

Servery MCP můžou poskytovat opakovaně použitelné šablony výzev, které vám pomůžou efektivněji pracovat s jazykovými modely. Tyto výzvy jsou přizpůsobené konkrétním úkolům a můžou obsahovat přizpůsobitelné argumenty.

Použití výzev MCP

Jak odkazovat na výzvy ze serveru MCP:

  1. V chatu vyberte + Přidat odkaz .
  2. Vyberte Výzvy>MCP výzvy.
  3. Zvolte výzvu a vyberte Vložit výzvu.

Některé výzvy obsahují argumenty, které si můžete přizpůsobit před vložením do chatu. Tyto šablony se nazývají šablony promptů.

Příklad: Server MCP GitHubu poskytuje výzvy k analýze žádostí o přijetí změn, generování zpráv potvrzení a kontrole změn kódu.

Instalace Programu MCP GitHubu v sadě Visual Studio

Prostředky MCP a šablony prostředků MCP

Prostředky MCP poskytují kontext k jazykovým modelům, jako jsou soubory, schémata databáze nebo data specifická pro aplikaci. Každý prostředek má jedinečný identifikátor URI, na který můžete odkazovat v chatu.

Použití prostředků MCP

Odkazujte na prostředky MCP v chatu Copilot pomocí hashtagu (#) následovaného identifikátorem URI prostředku.

Pro prostředky s argumenty (šablony prostředků):

  1. Vyberte + Přidat odkaz v chatu.
  2. Vyberte prostředky MCP.
  3. Vyberte prostředek, vyplňte všechny požadované argumenty a vyberte Přidat prostředek.

Příklad: Server McP Azure DevOps zveřejňuje zdroje pracovních položek, informace o sprintu a data o kapacitě týmu pro úkoly plánování projektů.

Instalujte v Azure DevOps MCP pro Visual Studio

Příklad: Server Figma MCP poskytuje přístup k prostředkům komponent návrhu, průvodcům stylu a specifikacím návrhu.

Instalace Figma MCP v aplikaci Visual Studio

Vzorkování MCP

Vzorkování umožňuje serverům MCP provádět volání na LLM vaším jménem, což umožňuje složitější a vícekrokové operace. Visual Studio automaticky podporuje vzorkování, pokud ho váš server MCP poskytuje.

Když Copilot bude muset uskutečnit vzorový hovor, zobrazí se potvrzovací dialogové okno. Zkontrolujte podrobnosti a schvalte před zahájením akce a zajistěte kontrolu nad automatizovanými operacemi.

Příklad: Server PLAYwright MCP používá vzorkování k vygenerování testovacích scénářů na základě struktury DOM vaší aplikace a toků uživatelů.

Instalace Playwright MCP v aplikaci Visual Studio

Nejčastější dotazy

Jak můžu jako správce řídit používání serverů MCP v režimu agenta pro uživatele sady Visual Studio?

Nastavení zásad GitHubu na řídicím panelu GitHub Copilot pro správce řídí režim agenta a používání MCP v sadě Visual Studio. Pokud správce toto nastavení vypne, nemůžou uživatelé v tomto předplatném používat režim agenta ani se připojovat k serverům MCP v sadě Visual Studio.

Další informace najdete v tématu Správa zásad a funkcí pro GitHub Copilot ve vašem podniku.