MCP Xnb

🚀 MCP PowerShell 模塊

這是一個用於在終端中構建符合MCP（可能是某個協議或標準的縮寫）規範的人工智能代理和工具的PowerShell模塊，能幫助開發者快速搭建MCP相關的服務和客戶端。

🚀 快速開始

本模塊可通過PowerShell命令進行安裝，安裝完成後即可使用。

📦 安裝指南

在PowerShell中執行以下命令進行安裝：

Install-Module MCP

💻 使用示例

基礎用法

服務器端示例

以下是一個完整的服務器端腳本，展示瞭如何使用該模塊創建一個MCP兼容的AI服務。

步驟說明：

1. 初始化日誌：創建一個新的日誌實例，並指定日誌目錄和最小日誌級別。
2. 配置並啟動服務器：
   • 使用 New-McpServer cmdlet 創建一個新的MCP服務器實例。
   • 配置服務器選項，如綁定地址、端口和其他高級設置。
   • 啟動服務器並監聽傳入請求。

代碼示例：

# 初始化日誌實例
$serverLogger = New-Logger -MinimumLevel Debug -Logdirectory "C:\Logs\MCPServer"

$server = $null
try {
    # 創建一個新的MCP服務器實例
    $server = New-McpServer `
        -BindAddress "0.0.0.0" `
        -Port 5000 `
        -Logger $serverLogger

    # 配置和啟動服務器
    Write-Host "Starting MCP Server..."
    $server.Start()

} catch {
    # 錯誤處理：記錄錯誤並終止程序
    $serverLogger.Fatal("Server failed to start.", $_.Exception)
    throw
}

客戶端示例

以下是一個完整的客戶端腳本，展示瞭如何連接到MCP服務器並調用其功能。

步驟說明：

1. 初始化日誌：創建一個新的日誌實例，並指定日誌目錄和最小日誌級別。
2. 創建客戶端實例：
   • 使用 New-McpClient cmdlet 創建一個新的MCP客戶端實例。
   • 配置客戶端選項，如目標服務器地址、端口和其他高級設置。
3. 連接到服務器並調用功能：
   • 使用異步方法調用遠程工具和服務。
   • 處理響應和錯誤。

代碼示例：

# 初始化日誌實例
$clientLogger = New-Logger -MinimumLevel Debug -Logdirectory "C:\Logs\MCPClient"

$client = $null
try {
    # 創建一個新的MCP客戶端實例
    $client = New-McpClient `
        -ServerAddress "http://localhost:5000" `
        -Logger $clientLogger

    Write-Host "Connecting to Server..."
    $client.Connect()

    # 示例：調用遠程工具
    $toolName = "example_tool"
    $arguments = @{ input = "Hello, World!" }

    $job = $client.CallToolAsync($toolName, $arguments)
    $job | Wait-Job

    if ($job.State -eq 'Completed') {
        $result = Receive-Job -Job $job
        Write-Host "Result: $($result.Content)"
    } else {
        Write-Error "Call failed: $($job.Error[0].Exception.Message)"
    }

} catch {
    # 錯誤處理：記錄錯誤並終止程序
    $clientLogger.Fatal("Client operation failed.", $_.Exception)
    throw
}

📄 許可證

該項目採用 WTFPL License 許可證。