MCP Xnb

🚀 MCP PowerShell Module

This is a PowerShell module designed to build AI agents and tools that comply with the MCP (possibly an abbreviation for a certain protocol or standard) specification in the terminal. It offers a seamless way to interact with MCP - based services and develop related applications.

🚀 Quick Start

Get started with the MCP PowerShell module by following the steps below.

📦 Installation

You can install the MCP module using the following command:

Install-Module MCP

💻 Usage Examples

Basic Usage

Server - side Example

The following is a complete server - side script demonstrating how to use the module to create an MCP - compatible AI service.

Step - by - Step Guide:

1. Initialize Logging: Create a new logger instance and specify the log directory and minimum log level.
2. Configure and Start the Server:
   • Use the New - McpServer cmdlet to create a new MCP server instance.
   • Configure server options such as the binding address, port, and other advanced settings.
   • Start the server and listen for incoming requests.

Code Example:

# Initialize the logger instance
$serverLogger = New-Logger -MinimumLevel Debug -Logdirectory "C:\Logs\MCPServer"

$server = $null
try {
    # Create a new MCP server instance
    $server = New-McpServer `
        -BindAddress "0.0.0.0" `
        -Port 5000 `
        -Logger $serverLogger

    # Configure and start the server
    Write-Host "Starting MCP Server..."
    $server.Start()

} catch {
    # Error handling: Log the error and terminate the program
    $serverLogger.Fatal("Server failed to start.", $_.Exception)
    throw
}

Client - side Example

The following is a complete client - side script showing how to connect to an MCP server and invoke its functions.

Step - by - Step Guide:

1. Initialize Logging: Create a new logger instance and specify the log directory and minimum log level.
2. Create a Client Instance:
   • Use the New - McpClient cmdlet to create a new MCP client instance.
   • Configure client options such as the target server address, port, and other advanced settings.
3. Connect to the Server and Invoke Functions:
   • Use asynchronous methods to call remote tools and services.
   • Handle responses and errors.

Code Example:

# Initialize the logger instance
$clientLogger = New-Logger -MinimumLevel Debug -Logdirectory "C:\Logs\MCPClient"

$client = $null
try {
    # Create a new MCP client instance
    $client = New-McpClient `
        -ServerAddress "http://localhost:5000" `
        -Logger $clientLogger

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

    # Example: Call a remote tool
    $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 {
    # Error handling: Log the error and terminate the program
    $clientLogger.Fatal("Client operation failed.", $_.Exception)
    throw
}

📄 License

This project is licensed under the WTFPL License.