pmcp 2.4.0

High-quality Rust SDK for Model Context Protocol (MCP) with full TypeScript SDK compatibility
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

# Installer for mcp-tester and mcp-preview binaries from GitHub releases.
# Downloads the correct Windows binary, verifies its SHA256 checksum,
# and installs it to a local bin directory.
#
# Usage:
#   irm https://raw.githubusercontent.com/paiml/rust-mcp-sdk/main/install/install.ps1 | iex
#   .\install.ps1 -Tool mcp-preview -Version v1.18.0

param(
    [string]$Tool = "mcp-tester",
    [string]$Version = "latest",
    [string]$InstallDir = "$env:USERPROFILE\.local\bin"
)

$ErrorActionPreference = "Stop"

# Validate tool name
if ($Tool -notin @("mcp-tester", "mcp-preview")) {
    Write-Error "Unknown tool '$Tool'. Must be mcp-tester or mcp-preview."
    exit 1
}

# Detect architecture
$arch = if ([System.Environment]::Is64BitOperatingSystem) { "X64" } else { "Unknown" }
# Use RuntimeInformation if available (PowerShell 6+)
try {
    $arch = [System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture.ToString()
} catch {
    # Fallback already set above
}

switch ($arch) {
    "X64"   { $target = "x86_64-pc-windows-msvc" }
    "Arm64" { Write-Error "ARM64 Windows binaries are not yet available. Only x86_64 is supported."; exit 1 }
    default { Write-Error "Unsupported architecture: $arch. Only x86_64 Windows binaries are available."; exit 1 }
}

Write-Host "Detected platform: $target"

# Build download URL
$assetName = "$Tool-$target.exe"
$repo = "paiml/rust-mcp-sdk"

if ($Version -eq "latest") {
    $url = "https://github.com/$repo/releases/latest/download/$assetName"
} else {
    $url = "https://github.com/$repo/releases/download/$Version/$assetName"
}
$checksumUrl = "$url.sha256"

# Download to temp directory
$tempDir = New-Item -ItemType Directory -Path (Join-Path ([System.IO.Path]::GetTempPath()) ([System.IO.Path]::GetRandomFileName()))
$binaryPath = Join-Path $tempDir $assetName
$checksumPath = Join-Path $tempDir "$assetName.sha256"

try {
    Write-Host "Downloading $assetName..."
    Invoke-WebRequest -Uri $url -OutFile $binaryPath -UseBasicParsing

    Write-Host "Downloading checksum..."
    Invoke-WebRequest -Uri $checksumUrl -OutFile $checksumPath -UseBasicParsing

    # Verify checksum
    Write-Host "Verifying checksum..."
    $expectedHash = (Get-Content $checksumPath).Trim().Split(" ", [StringSplitOptions]::RemoveEmptyEntries)[0]
    $actualHash = (Get-FileHash -Path $binaryPath -Algorithm SHA256).Hash.ToLower()

    if ($actualHash -ne $expectedHash) {
        Write-Error "Checksum mismatch! Expected: $expectedHash, Got: $actualHash"
        exit 1
    }
    Write-Host "Checksum verified."

    # Install
    if (-not (Test-Path $InstallDir)) {
        New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
    }
    $destPath = Join-Path $InstallDir "$Tool.exe"
    Move-Item -Path $binaryPath -Destination $destPath -Force

    Write-Host ""
    Write-Host "$Tool installed to $destPath"

    # Check PATH
    $currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
    if ($currentPath -notlike "*$InstallDir*") {
        Write-Host ""
        Write-Host "Warning: $InstallDir is not in your PATH."
        Write-Host "Add it with:"
        Write-Host "  [Environment]::SetEnvironmentVariable('PATH', `"$InstallDir;`$env:PATH`", 'User')"
    }
} finally {
    # Cleanup temp directory
    if (Test-Path $tempDir) {
        Remove-Item -Recurse -Force $tempDir -ErrorAction SilentlyContinue
    }
}