Installation Guide

Quick Install (One-liner)

For macOS and Linux, install with a single command:

curl -fsSL https://raw.githubusercontent.com/tuannvm/mcp-trino/main/install.sh -o install.sh && chmod +x install.sh && ./install.sh

Homebrew (macOS and Linux)

The easiest way to install mcp-trino is using Homebrew:

# Install mcp-trino
brew install tuannvm/mcp/mcp-trino

To update to the latest version:

brew update && brew upgrade mcp-trino

Alternative Installation Methods

Manual Download

1. Download the appropriate binary for your platform from the GitHub Releases page.
2. Place the binary in a directory included in your PATH (e.g., /usr/local/bin on Linux/macOS)
3. Make it executable (chmod +x mcp-trino on Linux/macOS)

From Source

git clone https://github.com/tuannvm/mcp-trino.git
cd mcp-trino
make build
# Binary will be in ./bin/

Downloads

You can download pre-built binaries for your platform:

Platform	Architecture	Download Link
macOS	x86_64 (Intel)	Download
macOS	ARM64 (Apple Silicon)	Download
Linux	x86_64	Download
Linux	ARM64	Download
Windows	x86_64	Download

Or see all available downloads on the GitHub Releases page.

Installation Troubleshooting

If you encounter issues during installation:

Common Issues:

• Binary not found in PATH: The install script installs to ~/.local/bin by default. Make sure this directory is in your PATH:

  export PATH="$HOME/.local/bin:$PATH"

  Add this to your shell profile (.bashrc, .zshrc, etc.) to make it permanent.
• Permission denied: If you get permission errors, ensure the install directory is writable:

  mkdir -p ~/.local/bin
  chmod 755 ~/.local/bin

• Claude configuration not found: If the install script doesn't detect your Claude installation:

  • For Claude Desktop: Check if the config file exists at the expected location
  • For Claude Code: Verify the claude command is available in PATH
  • Use the manual configuration instructions provided by the script
• GitHub API rate limiting: If you're hitting GitHub API rate limits:

  export GITHUB_TOKEN=your_github_token
  curl -fsSL https://raw.githubusercontent.com/tuannvm/mcp-trino/main/install.sh | bash

Getting Help:

• Check the GitHub Issues for similar problems
• Run the install script with --help for usage information
• Use manual installation methods if the automated script fails

Testing Your Installation

After installation, verify mcp-trino works correctly:

Test CLI Mode

# Verify binary is installed
mcp-trino --version

# Test with a local Trino instance (if available)
export TRINO_HOST=localhost TRINO_PORT=8080 TRINO_USER=trino
mcp-trino catalogs

# Or use config file (YAML or JSON)
mkdir -p ~/.config/trino
cat > ~/.config/trino/config.yaml << EOF
current: default
profiles:
  default:
    host: localhost
    port: 8080
    user: trino
    catalog: memory
    schema: default
EOF

mcp-trino catalogs

Test Interactive REPL

# Start interactive mode
mcp-trino --interactive

# In the REPL, try:
trino> \help
trino> \catalogs
trino> \quit

Test MCP Mode

# Should start MCP server (no args, no TTY)
echo "" | mcp-trino

# Should show "Starting Trino MCP Server" in output

For more CLI usage examples, see the CLI Mode section in the main README.