Rychlý start: MCP Hostovat v systému Windows

Tento článek ukazuje, jak může hostitelská aplikace MCP vypsat, připojit se a pracovat s MCP servery zaregistrovanými ve Windows pomocí nástroje Windows odr.exe registru agenta na zařízeníodr.exe. Tento názorný postup použije ukázkovou hostitelskou aplikaci z MCP úložiště ukázek pro Windows github.com/microsoft/mcp-on-windows-samples.

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ší
• MCP Hostitelská aplikace s identitou balíčku Další informace o identitě balíčku najdete v přehledu identity balíčku v aplikacích pro Windows. Identita balíčku se uděluje aplikacím zabaleným pomocí formátu balíčku MSIX. Další informace naleznete v tématu Co je MSIX?.
  • Poznámka Tento požadavek se ve verzi Public Preview nevynucuje, ale bude ve stabilní verzi.

Vytvoření klonu ukázky

Naklonujte ukázku z hostitele WindowsMCP do svého zařízení a přejděte na ni:

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

Nastavení a sestavení ukázky

Spusťte tyto příkazy:

npm install
npm run start

Nástroj vám nabídne uživatelské rozhraní příkazového řádku, které vám umožní pracovat se MCP servery zaregistrovanými na vašem zařízení. V následujících částech se zobrazí kód JavaScriptu, který nástroj používá k implementaci různých funkcí MCP hostitelské aplikace.

Výpis dostupných MCP serverů

Zobrazte seznam dostupných MCP serverů, které spouští volání odr.exe listpříkazového řádku . Tento příkaz vrátí seznam serverů ve formátu JSON, který se uloží a použije v dalších příkladech:

const { stdout, stderr } = await execFileAsync('odr.exe', ['list']);

if (stderr) {
    console.error('Warning:', stderr);
}

const servers = JSON.parse(stdout);

Připojení k MCP serveru

Připojte se k jednomu z dostupných MCP serverů získáním příkazu a argumentů z kódu JSON vráceného v předchozím kroku. Vytvořte StdioClientTransport a předejte příkaz a argumenty. Vytvořte nový Client objekt. Zavolejte connect k MCP serveru.

const command = server.manifest?.server?.mcp_config?.command;
const args = server.manifest?.server?.mcp_config?.args || [];

if (!command) {
    throw new Error('Server configuration missing command.');
}

// Create MCP client with stdio transport
// Set stderr to 'ignore' to silence server info logs
const transport = new StdioClientTransport({
    command: command,
    args: args,
    stderr: 'ignore'
});

const client = new Client({
    name: 'mcp-client',
    version: '1.0.0'
}, {
    capabilities: {}
});

// Connect to the server
await client.connect(transport);

Výpis nástrojů ze serveru

Zavolejte listTools, abyste vypsali nástroje registrované serverem MCP.

// List available tools
const toolsResponse = await client.listTools();
const tools = toolsResponse.tools || [];

Volání nástroje

Každý MCP nástroj má název a volitelnou sadu parametrů. Funkce gatherToolParameters v ukázce vám pomůže shromáždit vstupní parametry, a poté můžete přímo volat nástroj:

const parameters = await gatherToolParameters(tool); // This function is from the sample code

const result = await client.callTool({
    name: tool.name,
    arguments: parameters
});

Další kroky

• Zjistěte, jak sestavit a zaregistrovat MCP server, který je možné zjistit a používat hostitelskou aplikací. Další informace najdete v tématu Registrace MCP serveru.