Schnellstart: MCP Hosten unter Windows

In diesem Artikel wird gezeigt, wie eine MCP Host-App mithilfe des Windows odr.exe on-device Agent-Registrierungstools unter Windows registrierte Server auflisten, eine Verbindung zu ihnen herstellen und mit ihnen interagieren kann. Bei diesem Tutorial wird eine Beispiel-Hostanwendung aus dem MCP Windows-Beispiel-Repository github.com/microsoft/mcp-on-windows-samples verwendet.

Hinweis

Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.

Voraussetzungen

• Windows Build 26220.7262 oder höher
• Eine MCP Host-App mit Paket-Identität. Weitere Informationen zur Paketidentität finden Sie in einer Übersicht über die Paketidentität in Windows-Apps. Die Paketidentität wird Apps gewährt, die mit dem MSIX-Paketformat gepackt werden. Weitere Informationen finden Sie unter Was ist MSIX?.
  • Anmerkung Diese Anforderung wird nicht in der öffentlichen Vorschauversion erzwungen, sondern in der stabilen Version.

Klonen des Beispiels

Klonen Sie das MCP Windows-Hostbeispiel auf Ihr Gerät, und navigieren Sie zu diesem:

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

Einrichten und Erstellen des Beispielprojekts

Führen Sie diese Befehle aus:

npm install
npm run start

Das Tool stellt Ihnen eine Befehlszeilen-Benutzeroberfläche bereit, mit der Sie mit den MCP auf Ihrem Gerät registrierten Servern interagieren können. In den folgenden Abschnitten wird der Javascript-Code angezeigt, der vom Tool zum Implementieren verschiedener Features einer MCP Host-App verwendet wird.

Die vorhandenen MCP Server auflisten

Auflisten der verfügbaren MCP Server, die den Befehlszeilenaufruf odr.exe listausführen. Dieser Befehl gibt die Liste der Server im JSON-Format zurück, die in nachfolgenden Beispielen gespeichert und verwendet wird:

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

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

const servers = JSON.parse(stdout);

Herstellen einer Verbindung mit einem MCP Server

Stellen Sie eine Verbindung mit einem der verfügbaren MCP Server her, indem Sie den Befehl und die Argumente aus dem im vorherigen Schritt zurückgegebenen JSON abrufen. Erstellen Sie ein StdioClientTransport, und übergeben Sie den Befehl und die Argumente. Erstellen Sie ein neues Client Objekt. Verbinden Sie sich mit , um eine Verbindung mit dem Server herzustellen.

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);

Auflisten von Tools von einem Server

Rufen Sie listTools auf, um die Tools auflisten, die vom MCP Server registriert sind.

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

Aufrufen eines Tools

Jedes MCP Tool verfügt über einen Namen und einen optionalen Satz von Parametern. Die gatherToolParameters Funktion im Beispiel hilft beim Sammeln von Eingabeparametern, und Sie können das Tool dann direkt aufrufen:

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

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

Nächste Schritte

• Erfahren Sie, wie Sie einen MCP Server erstellen und registrieren, der von einer Host-App erkannt und verwendet werden kann. Weitere Informationen finden Sie unter Registrieren eines MCP Servers.