Sdílet prostřednictvím

MCP Registrace serveru z aplikace s identitou balíčku

Tento článek popisuje, jak může aplikace s identitou balíčku zaregistrovat MCP server tím, že si projde ukázku z MCP úložiště ukázek ve Windows , github.com/microsoft/mcp-on-windows-samples, a ilustruje, jak aplikace s identitou balíčku registruje MCP server. Když do zabalené aplikace přidáte požadovaná metadata, operační systém po instalaci balíčku aplikace automaticky zaregistruje server. Aplikace, které používají formát balíčku MSIX, mají identitu balíčku. Rozbalené aplikace se dají udělit identitě balíčku vytvořením a registrací balíčku do externího umístění ve vaší aplikaci. Další informace najdete v tématu Udělení identity balíčku zabalením s externím umístěním.

Pokud máte aplikaci, která nemá identitu balíčku, například takovou, která je nainstalovaná pomocí MSI nebo jen samostatného .exe, a nechcete použít balíček MSIX k udělení identity balíčku, můžete nainstalovat server MCP pomocí MCP balíku. Pro více informací se podívejte na Registrace MCP serveru do MCP sady.

Poznámka:

Některé informace se týkají předem vydaného produktu, který může být podstatně změněn před komerčním vydáním. Společnost Microsoft neposkytuje žádné záruky, výslovné ani implicitní, ohledně zde poskytnutých informací.

Požadavky

  • Windows build 26220.7262 nebo novější
  • Ujistěte se, že máte nejnovější SignTool.exeverze 10.0.26100.4188 nebo novější. Nástroj SignTool.exe je součástí sady Windows SDK. Nejnovější sadu Windows SDK můžete získat pomocí nástroje WinGet. winget install Microsoft.WindowsSDK.10.0.26100
  • V produkčních verzích budete potřebovat certifikát, který je součástí programu Microsoft Trusted Root Program.
  • Server MCP . Další informace najdete v přehledu MCP serveru.
  • Aplikace s identitou balíčku a souborem AppxManifest.xml
  • Je nainstalovaný NodeJS. Pokud chcete nainstalovat NodeJS pomocí winGetu, použijte následující příkaz:
    • winget install OpenJS.NodeJS

Přehled

MCP Přidání serveru do aplikace s identitou balíčku zahrnuje následující kroky:

  • MCP Přidejte soubor balíčku, manifest.json který popisuje váš server, MCP do vašeho projektu. Další informace o formátu tohoto souboru najdete v MCP úložišti GitHub sady github.com/anthropics/mcpb/.
  • Do souboru přidejte položku AppxManifest.xml.

Vytvoření klonu ukázky

Naklonujte repozitář ukázkových příkladů Windows MCP.

git clone https://github.com/microsoft/mcp-on-windows-samples.git

Soubor řešení pro aplikaci MSIX, která registruje MCP server, je v mcp-on-windows-samples\msix-app-with-server\ adresáři.

Nastavení a sestavení ukázky

.sln Otevřete soubor z ukázky v sadě Visual Studio a v rozevíracím seznamu Platformy řešení vyberte správnou architekturu pro vaše zařízení.

Aplikace vyžaduje k úspěšnému sestavení certifikát. Přidání testovacího certifikátu:

  1. Ve Průzkumníku řešení, v rámci projektu mcp-server-msix, dvakrát klikněte na soubor Package.appxmanifest a otevřete editor manifestu balíčku.
  2. Na kartě Balení klepněte na tlačítko Zvolit certifikát.
  3. V dialogovém okně Zvolit certifikát klikněte na Vytvořit...
  4. Ve všech polích ponechte výchozí hodnoty a klikněte na TLAČÍTKO OK. Dalším kliknutím na OK dokončete proces vytváření certifikátu.

Sestavte ukázku. V Průzkumníkumcp-server-msix řešení klikněte pravým tlačítkem na projekt a vyberte Nasadit. Teď spusťte aplikaci.

Dále spusťte MCP server tak, že otevřete příkaz PowerShellu pro danou složku a spustíte následující příkaz. Možná budete muset změnit cestu na základě architektury vašeho počítače.

npx @modelcontextprotocol/inspector .\McpServer\bin\x64\Debug\net8.0\McpServer.exe

Tento příkaz spustí MCP server. Spustí se také MCP inspektor, nástroj pro interakci se MCP servery v okně prohlížeče. Přepněte zpátky do ukázkové aplikace, abyste k interakci se serverem MCP použili uživatelské rozhraní aplikace.

V dalším průběhu tohoto názorného postupu budou představeny komponenty této ukázkové aplikace vedoucí k jejich registraci při instalaci.

Konfigurační MCP soubor JSON sady (MCPB)

Konfigurační MCP soubor JSON sady (MCPB) popisuje váš server a jak s ním pracovat. Konfigurační MCP soubor JSON sady pro ukázkový projekt se nachází v souboru Assets/manifest.json. Níže je uvedený výpis kódu. Všimněte si, že poskytuje metadata, jako je název, popis a autor serveru. Dále definuje tři různé nástroje a definuje očekávané vstupní typy. Podrobný popis formátu konfiguračního souboru MCPB najdete v tématu MCPB Manifest.json Specifikace v úložišti GITHub MCPB.

Všimněte si, že hodnoty v části _meta konfiguračního souboru MCPB musí odpovídat tomu, co váš server vrací za běhu, aby se server spustil ve výchozím režimu. Další informace najdete v části _meta konfiguračního souboru JSON MCPB.

{
  "manifest_version": "0.1",
  "name": "MCP-Server-Sample-App",
  "version": "1.0.0",
  "description": "A Sample App MCP Server",
  "author": {
    "name": "Microsoft"
  },
  "server": {
    "type": "binary",
    "entry_point": "SampleMCPServer.McpServer.exe",
    "mcp_config": {
      "command": "SampleMCPServer.McpServer.exe",
      "args": []
    }
  },
  "tools": [
    {
      "name": "get_random_fact",
      "description": "Gets a random interesting fact from an online API."
    },
    {
      "name": "get_random_quote",
      "description": "Gets a random inspirational quote from an online API."
    },
    {
      "name": "get_weather",
      "description": "Gets current weather information for a specified city."
    }
  ],
  "tools_generated": false,
  "license": "MIT",
  "_meta": {
    "com.microsoft.windows": {
      "static_responses": {
        "initialize": {
          "protocolVersion": "2025-06-18",
          "capabilities": {
            "logging": {},
            "tools": {
              "listChanged": true
            }
          },
          "serverInfo": {
            "name": "McpServer",
            "version": "1.0.0.0"
          }
        },
        "tools/list": {
          "tools": [
            {
              "name": "get_random_quote",
              "description": "Gets a random inspirational quote from an online API.",
              "inputSchema": {
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "get_random_fact",
              "description": "Gets a random interesting fact from an online API.",
              "inputSchema": {
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "get_weather",
              "description": "Gets current weather information for a specified city.",
              "inputSchema": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": "string",
                    "default": "London"
                  }
                }
              }
            }
          ]
        }
      }
    }
  }
}

Položka MCP rozšíření aplikace v souboru manifestu balíčku

Server MCP zaregistrujete v systému přidáním elementu uap3:AppExtension do souboru manifestu balíčku vaší aplikace. AppxManifest.xml Název rozšíření je com.microsoft.windows.ai.mcpServer. Toto rozšíření umožňuje systému Windows zaregistrovat a zrušit registraci MCP serveru při instalaci nebo odinstalaci aplikace. Uap5:AppExecutionAlias určuje systému spustitelný soubor pro váš MCP server.

<Extensions>
	<uap3:Extension Category="windows.appExtension">
		<uap3:AppExtension
			Name="com.microsoft.windows.ai.mcpServer"
			Id="WindowsMCPServerSampleApp"
			DisplayName="Windows Sample MCP Server"
			PublicFolder="Assets">
			<uap3:Properties>
				<Registration>mcpServerConfig.json</Registration>
			</uap3:Properties>
		</uap3:AppExtension>
	</uap3:Extension>

	<uap5:Extension Category="windows.appExecutionAlias">
		<uap5:AppExecutionAlias>
			<uap5:ExecutionAlias Alias="WindowsMCPServerSampleApp.exe"/>
		</uap5:AppExecutionAlias>
	</uap5:Extension>
</Extensions>

Kód ukázkového projektu můžete zobrazit tak, že kliknete pravým tlačítkem na Package.appxmanifest soubor a vyberete Zobrazit kód.

Možnosti požadavků na váš server

Server MCP zaregistrovaný v aplikaci balíčku se spustí v obsaženém prostředí, což znamená, že ve výchozím nastavení nebude mít přístup k chráněným prostředkům, jako jsou soubory aktuálního uživatele. Další informace naleznete v tématu MCP.

Přístup k sadám prostředků můžete požádat deklarací možností v souboru manifestu aplikace. Po přístupu k serveru systém vyzve uživatele, aby povolil přístup k požadovaným prostředkům. Většinu funkcí je možné nastavit přímo v uživatelském rozhraní editoru manifestu. Mezi běžné prostředky, ke kterým je možné získat přístup prostřednictvím funkcí, patří:

  • documentsLibrary – Uděluje přístup ke složce Dokumenty uživatele.
  • downloadsFolder – Uděluje přístup ke složce Stažené soubory uživatele.
  • picturesLibrary – Uděluje přístup ke složce Obrázky uživatele.
  • musicLibrary – Uděluje přístup ke složce Hudba uživatele.
  • videosLibrary – Uděluje přístup ke složce Videa uživatele.

Další informace o možnostech najdete v tématu Deklarace schopností aplikace.

Otestování MCP serveru

Informace o testování registrace a funkčnosti MCP serveru naleznete v tématu Testování MCP serverů ve Windows.

  • Last updated on