param(
[Parameter(Mandatory=$true)]
[string]$InstallDir
)
# Configure Claude Desktop for Foundry MCP Server
# This script safely merges MCP server configuration into existing Claude Desktop config
$ErrorActionPreference = "Stop"
# Enhanced logging with file output
$LogFile = Join-Path $env:TEMP "foundry-mcp-claude-config.log"
function Write-LogMessage {
param([string]$Message, [string]$Level = "INFO")
$timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
$logEntry = "[$timestamp] [$Level] $Message"
Write-Host $logEntry
Add-Content -Path $LogFile -Value $logEntry -ErrorAction SilentlyContinue
}
function Test-JsonValid {
param([string]$JsonString)
try {
$JsonString | ConvertFrom-Json | Out-Null
return $true
}
catch {
return $false
}
}
function Get-ConfigFileState {
param([string]$ConfigPath)
if (-not (Test-Path $ConfigPath)) {
return "Missing"
}
$content = Get-Content $ConfigPath -Raw -ErrorAction SilentlyContinue
if (-not $content) {
return "Empty"
}
$content = $content.Trim()
# Check for common corruption patterns
if ($content -eq "{") {
return "PartialOpen"
}
if ($content -eq "}") {
return "PartialClose"
}
if ($content.StartsWith("{") -and -not $content.EndsWith("}")) {
return "IncompleteJSON"
}
if (-not $content.StartsWith("{")) {
return "InvalidFormat"
}
# Test if it's valid JSON
if (Test-JsonValid $content) {
return "ValidJSON"
}
else {
return "CorruptedJSON"
}
}
try {
Write-LogMessage "=============================================="
Write-LogMessage "Starting Claude Desktop configuration..."
Write-LogMessage "=============================================="
Write-LogMessage "Log file location: $LogFile"
Write-LogMessage "PowerShell version: $($PSVersionTable.PSVersion)"
Write-LogMessage "Current user: $($env:USERNAME)"
Write-LogMessage "Install directory: $InstallDir"
Write-LogMessage "APPDATA: $($env:APPDATA)"
Write-LogMessage "Script parameters: $($PSBoundParameters | ConvertTo-Json)"
# Validate installation directory exists
if (-not (Test-Path $InstallDir)) {
throw "Installation directory does not exist: $InstallDir"
}
# Validate required files exist
$nodeExe = Join-Path $InstallDir "node.exe"
$mcpServer = Join-Path $InstallDir "foundry-mcp-server\packages\mcp-server\dist\index.cjs"
if (-not (Test-Path $nodeExe)) {
throw "Node.js executable not found: $nodeExe"
}
if (-not (Test-Path $mcpServer)) {
throw "MCP server not found: $mcpServer"
}
Write-LogMessage "Installation files validated"
# Determine Claude Desktop config path
$claudeConfigDir = Join-Path $env:APPDATA "Claude"
$configPath = Join-Path $claudeConfigDir "claude_desktop_config.json"
Write-LogMessage "Claude config path: $configPath"
# Ensure Claude directory exists
if (-not (Test-Path $claudeConfigDir)) {
Write-LogMessage "Creating Claude Desktop directory..."
New-Item -ItemType Directory -Path $claudeConfigDir -Force | Out-Null
}
# Analyze and handle existing configuration
$config = $null
$backupPath = $null
$fileState = Get-ConfigFileState $configPath
Write-LogMessage "Claude config file state: $fileState"
switch ($fileState) {
"Missing" {
Write-LogMessage "No existing configuration found, creating new..."
$config = [PSCustomObject]@{
mcpServers = [PSCustomObject]@{}
}
}
{ $_ -in "Empty", "PartialOpen", "PartialClose", "IncompleteJSON", "InvalidFormat", "CorruptedJSON" } {
Write-LogMessage "Configuration file is corrupted ($fileState), recreating from scratch..."
# Create backup of corrupted file for troubleshooting
if (Test-Path $configPath) {
$backupPath = "$configPath.corrupted-backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
Copy-Item $configPath $backupPath
Write-LogMessage "Backed up corrupted file: $backupPath"
}
# Create fresh configuration
$config = [PSCustomObject]@{
mcpServers = [PSCustomObject]@{}
}
}
"ValidJSON" {
Write-LogMessage "Reading existing valid configuration..."
# Create backup
$backupPath = "$configPath.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
Copy-Item $configPath $backupPath
Write-LogMessage "Created backup: $backupPath"
try {
$configContent = Get-Content $configPath -Raw
$config = $configContent | ConvertFrom-Json
Write-LogMessage "Existing configuration loaded successfully"
# Log basic structure (not full content to avoid huge logs)
$propCount = $config.PSObject.Properties.Name.Count
Write-LogMessage "Configuration has $propCount top-level properties"
}
catch {
Write-LogMessage "Failed to parse supposedly valid JSON, recreating..." "ERROR"
$config = [PSCustomObject]@{
mcpServers = [PSCustomObject]@{}
}
}
}
}
# Ensure mcpServers section exists and is valid
if (-not $config.PSObject.Properties.Name -contains "mcpServers" -or $null -eq $config.mcpServers) {
Write-LogMessage "Adding mcpServers section to configuration..."
if ($config.PSObject.Properties.Name -contains "mcpServers") {
$config.mcpServers = [PSCustomObject]@{}
} else {
$config | Add-Member -Type NoteProperty -Name "mcpServers" -Value ([PSCustomObject]@{})
}
}
# Configure Foundry MCP Server
Write-LogMessage "Configuring Foundry MCP Server..."
$foundryMcpConfig = [PSCustomObject]@{
command = $nodeExe
args = @($mcpServer)
env = [PSCustomObject]@{}
}
# Add or update foundry-mcp server configuration
if ($config.mcpServers.PSObject.Properties.Name -contains "foundry-mcp") {
Write-LogMessage "Updating existing foundry-mcp configuration..."
$config.mcpServers."foundry-mcp" = $foundryMcpConfig
}
else {
Write-LogMessage "Adding new foundry-mcp configuration..."
$config.mcpServers | Add-Member -Type NoteProperty -Name "foundry-mcp" -Value $foundryMcpConfig
}
# Convert to JSON with proper formatting for Claude Desktop
Write-LogMessage "Generating new configuration JSON..."
# Use PowerShell's ConvertTo-Json - it handles escaping correctly
$newConfigJson = $config | ConvertTo-Json -Depth 10
# Validate generated JSON
if (-not (Test-JsonValid $newConfigJson)) {
throw "Generated configuration JSON is invalid"
}
Write-LogMessage "Generated configuration validated"
# Write new configuration
try {
# Use UTF8 without BOM for better compatibility
[System.IO.File]::WriteAllText($configPath, $newConfigJson, [System.Text.UTF8Encoding]::new($false))
Write-LogMessage "Claude Desktop configuration updated successfully"
}
catch {
# Restore backup if write failed
if ($backupPath -and (Test-Path $backupPath)) {
Write-LogMessage "Write failed, restoring backup..."
Copy-Item $backupPath $configPath -Force
}
throw "Failed to write Claude Desktop configuration: $($_.Exception.Message)"
}
# Verify written file is valid
try {
$verification = Get-Content $configPath -Raw | ConvertFrom-Json
Write-LogMessage "Written configuration verified"
}
catch {
# Restore backup if verification failed
if ($backupPath -and (Test-Path $backupPath)) {
Write-LogMessage "Verification failed, restoring backup..."
Copy-Item $backupPath $configPath -Force
}
throw "Written configuration file is invalid: $($_.Exception.Message)"
}
Write-LogMessage "Claude Desktop configuration completed successfully"
Write-LogMessage "Please restart Claude Desktop to load the new configuration"
exit 0
}
catch {
$errorMsg = $_.Exception.Message
Write-LogMessage "Configuration failed: $errorMsg" "ERROR"
Write-LogMessage "Full exception details: $($_.Exception | ConvertTo-Json -Depth 3)" "ERROR"
Write-LogMessage "Stack trace: $($_.ScriptStackTrace)" "ERROR"
Write-LogMessage "The Claude Desktop configuration was not modified" "ERROR"
Write-LogMessage "=============================================="
Write-LogMessage "For detailed error information, check: $LogFile" "ERROR"
Write-LogMessage "=============================================="
# Provide concise error message for NSIS/user display
$shortError = switch -Wildcard ($errorMsg) {
"*MCP server not found*" { "MCP server files missing from installation" }
"*Node.js executable not found*" { "Node.js runtime missing from installation" }
"*Installation directory does not exist*" { "Installation directory not found" }
"*Cannot bind argument*" { "Claude Desktop configuration format error" }
"*ConvertFrom-Json*" { "Claude Desktop configuration file corrupted" }
"*Access*denied*" { "Permission denied accessing Claude Desktop configuration" }
Default { "Claude Desktop configuration failed" }
}
Write-Error "$shortError. Details in log: $LogFile"
exit 1
}
