MCP Xnb

🚀 MCP PowerShell モジュール

このPowerShellモジュールは、ターミナル内でMCP（特定のプロトコルまたは標準の略称かもしれません）規格に準拠した人工知能エージェントとツールを構築するために使用されます。

🚀 クイックスタート

このモジュールを使用することで、ターミナル上でMCP規格に準拠したAIサービスやクライアントを簡単に構築できます。

📦 インストール

以下のコマンドを使用して、MCPモジュールをインストールします。

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 ライセンスの下で提供されています。