Building from Source¶

Go¶

Requires Go 1.26 or newer.

cd go
go test ./...
go vet ./...
golangci-lint run
go build -ldflags="-s -w -X main.version=dev" -trimpath -o psi-mcp-go .

Cross-compile by setting GOOS, GOARCH, and CGO_ENABLED=0.

C# Native AOT¶

Requires the .NET 10 SDK and the platform's native linker toolchain.

cd csharp
dotnet test PageSpeedMcp.slnx -c Release
dotnet publish src/PageSpeedMcp/PageSpeedMcp.csproj \
  -r linux-x64 \
  -c Release \
  --self-contained true

Platform	RID
Linux x64	`linux-x64`
Linux ARM64	`linux-arm64`
macOS Intel	`osx-x64`
macOS Apple Silicon	`osx-arm64`
Windows x64	`win-x64`
Windows ARM64	`win-arm64`

Running HTTP locally¶

cd go
go run . --transport http --listen-address 127.0.0.1 --port 8080 \
  --api-key YOUR_KEY

cd csharp
dotnet run --project src/PageSpeedMcp -- \
  --transport http --listen-address 127.0.0.1 --port 8080 \
  --api-key YOUR_KEY

Both commands expose MCP at /mcp and health metadata at /health.