hyperdb-mcp 0.6.1

MCP server for Hyper database — instant SQL analytics for LLM workflows
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

#!/usr/bin/env node
// Copyright (c) 2026, Salesforce, Inc. All rights reserved.
// SPDX-License-Identifier: Apache-2.0 OR MIT

const { execFileSync } = require('child_process')
const { join, dirname } = require('path')
const { existsSync } = require('fs')

const { platform, arch } = process

function getPlatformPackage() {
  switch (platform) {
    case 'darwin':
      // darwin-x64 builds are disabled until macos-13 GHA runners are
      // reliable again — see npm-build-publish.yml matrix.
      return arch === 'arm64' ? 'hyperdb-mcp-darwin-arm64' : null
    case 'linux':
      return 'hyperdb-mcp-linux-x64-gnu'
    case 'win32':
      return 'hyperdb-mcp-win32-x64-msvc'
    default:
      return null
  }
}

function getBinaryName() {
  return platform === 'win32' ? 'hyperdb-mcp.exe' : 'hyperdb-mcp'
}

function getHyperdName() {
  return platform === 'win32' ? 'hyperd.exe' : 'hyperd'
}

function findBinary() {
  const pkg = getPlatformPackage()
  if (!pkg) {
    throw new Error(`Unsupported platform: ${platform}-${arch}`)
  }

  // Try resolving from the installed platform package
  try {
    const pkgDir = dirname(require.resolve(`${pkg}/package.json`))
    const bin = join(pkgDir, getBinaryName())
    if (existsSync(bin)) return { bin, dir: pkgDir }
  } catch (_) {}

  // Fallback: binary in platform subdirectory (local dev / assemble-npm.sh)
  const platformDir = pkg.replace('hyperdb-mcp-', '')
  const subdir = join(__dirname, platformDir)
  const subdirBin = join(subdir, getBinaryName())
  if (existsSync(subdirBin)) return { bin: subdirBin, dir: subdir }

  // Fallback: binary in same directory
  const localBin = join(__dirname, getBinaryName())
  if (existsSync(localBin)) return { bin: localBin, dir: __dirname }

  throw new Error(
    `Could not find hyperdb-mcp binary for ${platform}-${arch}. ` +
    `Expected platform package: ${pkg}`
  )
}

const { bin, dir } = findBinary()

// Point hyperdb-mcp at the bundled hyperd if not already set
if (!process.env.HYPERD_PATH) {
  const hyperd = join(dir, getHyperdName())
  if (existsSync(hyperd)) {
    process.env.HYPERD_PATH = hyperd
  }
}

// Spawn the MCP server, inheriting stdio for MCP protocol communication
const result = require('child_process').spawnSync(bin, process.argv.slice(2), {
  stdio: 'inherit',
  env: process.env,
})

if (result.error) {
  throw result.error
}

process.exit(result.status ?? 1)