Run the server from source

Try an unreleased change, or point a client at a local build. You need Node.js 22 or later, pnpm and a clone of the repository.

Build and run

From the repository root:

pnpm install
pnpm turbo run build --filter=@sezzlee/postgres-mcp

Build through Turbo, not pnpm --filter @sezzlee/postgres-mcp build. The server depends on @sezzlee/db-core through its built dist/, and only Turbo builds it first.

Set the connection variables, then start the build:

SEZZLEE_POSTGRES_SERVER=db.example.com SEZZLEE_POSTGRES_DATABASE=sales \
SEZZLEE_POSTGRES_USER=mcp_reader SEZZLEE_POSTGRES_PASSWORD=... \
node packages/servers/postgres-mcp/dist/cli.js

To use the build from a client, set "command": "node", "args": ["/absolute/path/to/sezzlee/packages/servers/postgres-mcp/dist/cli.js"] and the same env block as for the published package.

Call it by hand

npx @modelcontextprotocol/inspector -e SEZZLEE_POSTGRES_SERVER=db.example.com -e SEZZLEE_POSTGRES_DATABASE=sales \
  -e SEZZLEE_POSTGRES_USER=mcp_reader -e SEZZLEE_POSTGRES_PASSWORD=... \
  node packages/servers/postgres-mcp/dist/cli.js

The Inspector starts the server with only a few variables of its own environment, so pass the connection with -e. This opens its web interface with the server connected.

Test it

pnpm turbo run test --filter=@sezzlee/postgres-mcp
pnpm turbo run check-types lint --filter=@sezzlee/postgres-mcp

These tests use fake drivers and need no database.