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 许可证。