Hızlı başlangıç: MCP Windows'ta barındırma

Bu makalede, bir MCP konak uygulamasının MCP kullanarak Windows'ta kayıtlı sunucuları nasıl listeleyebileceğiniz, bağlanabileceği ve bunlarla odr.exe nasıl etkileşim kurabileceği gösterilmektedir. Bu kılavuzda Windows örnekleri deposundaki MCPgithub.com/microsoft/mcp-on-windows-samples örnek bir konak uygulaması kullanılır.

Uyarı

Bazı bilgiler, ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilebilen, önceden yayımlanan ürünle ilgilidir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

Önkoşullar

• Windows derlemesi 26220.7262 veya üzeri
• Paket kimliğine sahip bir MCP ana bilgisayar uygulaması. Paket kimliği hakkında daha fazla bilgi için bkz. Windows uygulamalarında Paket Kimliğine genel bakış. Paket kimliği, MSIX paket biçimi kullanılarak paketlenen uygulamalara verilir. Daha fazla bilgi için bkz. MSIX nedir?.
  • Not Bu gereksinim genel önizleme sürümünde uygulanmaz, ancak kararlı sürümde olacaktır.

Örneği

Windows ana bilgisayar örneğiniMCP cihazınıza kopyalayın ve bu örneğe gidin:

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

Örneği kur ve derle

Şu komutları çalıştırın:

npm install
npm run start

Araç, cihazınızda kayıtlı sunucularla MCP etkileşim kurmanızı sağlayan bir komut satırı kullanıcı arabirimi sunar. Aşağıdaki bölümlerde, bir MCP konak uygulamasının çeşitli özelliklerini uygulamak için araç tarafından kullanılan Javascript kodu gösterilir.

Kullanılabilir MCP sunucuları listeleme

Komut satırı çağrısını MCPyürüten kullanılabilir odr.exe list sunucuları listeleyin. Bu komut, sonraki örneklerde depolanan ve kullanılan JSON biçimindeki sunucuların listesini döndürür:

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

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

const servers = JSON.parse(stdout);

Sunucuya MCP bağlanma

Önceki adımda döndürülen JSON'daki komut ve bağımsız değişkenleri alarak mevcut MCP sunuculardan birine bağlanın. komutunu ve bağımsız değişkenlerini geçirerek bir StdioClientTransportoluşturun. Yeni Client bir nesne oluşturun. Sunucuya bağlanmak için connect çağrısı.MCP

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

Bir sunucudan gelen araçları listeleme

Sunucu tarafından kaydedilen araçları listelemek için çağrısı listTools yapın MCP .

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

Araç çağırma

Her MCP aracın bir adı ve isteğe bağlı bir parametre kümesi vardır. gatherToolParameters Örnekteki işlev giriş parametrelerini toplamaya yardımcı olur ve ardından aracı doğrudan çağırabilirsiniz:

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

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

Sonraki Adımlar

• Ana uygulama tarafından bulunabilen ve kullanılabilen bir MCP sunucuyu nasıl oluşturacağınızı ve kaydedeceğinizi öğrenin. Daha fazla bilgi için Sunucu KaydetmeMCP'ye bakın.