Install prest-mcp, the official stdio adapter for pREST’s HTTP MCP endpoint. Use it when your MCP client expects a stdio process instead of calling /_mcp over HTTP directly.
Repository: prest/prest-mcp-adapter · Homebrew: prest/homebrew-tap
Requires pREST v2.1.0+ with /_mcp available. The adapter is a transport bridge only — tools and SQL live in pREST (MCP Overview).
brew install prest/tap/prest-mcpOr tap first:
brew tap prest/tap
brew install prest-mcpStep-by-step: Install adapter with Homebrew. For prestd itself, see Start with Homebrew.
go install github.com/prest/prest-mcp-adapter/cmd/prest-mcp@latestEnsure $(go env GOPATH)/bin is on your PATH.
Run against pREST on the host (Docker Desktop):
Published name: io.github.prest/prest
Use this identifier when installing from the MCP Registry or clients that resolve registry packages.
PREST_MCP_URL
yes
—
URL of the pREST HTTP MCP endpoint, e.g. http://localhost:3000/_mcp
PREST_MCP_TOKEN
no
—
Bearer token when pREST auth is enabled
PREST_MCP_TIMEOUT_MS
no
30000
HTTP timeout in milliseconds
With a JWT (when auth is enabled):
Protocol messages are newline-delimited JSON-RPC on stdin/stdout. Logs go only to stderr.
Minimal stdio server entry (Cursor, Claude Desktop, and similar clients):
VS Code / Copilot uses "servers" and "type": "stdio" instead — see Use with VS Code and Copilot.
Add PREST_MCP_TOKEN when auth is enabled. If prest-mcp is not on PATH, set "command" to the absolute binary path (Homebrew: typically /opt/homebrew/bin/prest-mcp on Apple Silicon, /usr/local/bin/prest-mcp on Intel Mac).
Client walkthroughs:
Adapter exits immediately mentioning PREST_MCP_URL
Environment variable not set
Client shows server disconnected / failed to start
prest-mcp not on PATH, or wrong absolute path in config
401 / 403 from tools
Auth enabled but PREST_MCP_TOKEN missing or invalid
Connection refused / timeout
pREST not running, wrong host/port, or Docker networking (host.docker.internal)
Empty tool list
ACL hides all tables — see Permissions and MCP over HTTP
Protocol reference: MCP over HTTP
Last updated
docker pull ghcr.io/prest/prest-mcp-adapter:0.1.3docker run --rm -i \
-e PREST_MCP_URL=http://host.docker.internal:3000/_mcp \
ghcr.io/prest/prest-mcp-adapter:0.1.3PREST_MCP_URL=http://localhost:3000/_mcp prest-mcpPREST_MCP_URL=https://api.example.com/_mcp \
PREST_MCP_TOKEN=secret \
prest-mcp{
"mcpServers": {
"prest": {
"command": "prest-mcp",
"env": {
"PREST_MCP_URL": "http://localhost:3000/_mcp"
}
}
}
}