mcp-trino-v1.3.1

Highlights

trino_describe_table sample now reaches structured-only clients (#71)

When called with include_sample=true, trino_describe_table fetched up to five sample rows and rendered them inside the Markdown text content block. MCP clients that consume a tool's structured output and ignore text content never received the sample, so the rows were effectively invisible to them.

This release carries the sample rows through to the structured result. DescribeTableOutput.Sample is now populated from the same fetched rows, so the sample appears in both representations:

• Text content block (unchanged): the existing ### Sample Data JSON fenced block.
• Structured output (new): sample in the typed DescribeTableOutput.

The change is purely additive. Text-rendering clients see no difference; structured-rendering clients now get the sample they were missing.

Behavior details

• The sample remains best-effort. A failed or empty sample query yields no rows and no error, exactly as before; describe_table still returns the column schema.
• No new query is issued. The structured sample is the same five-row SELECT ... LIMIT 5 result already used for the text block.
• Sample rows are typed as []map[string]any, matching the existing client.QueryResult.Rows.

This is the upstream half of txn2/mcp-data-platform#574. The data platform consumes this toolkit as a module and will pick the sample up after bumping to v1.3.1.

Internal

• Extracted a defaultLocalhost constant in the file-based config (pkg/extensions/config_file.go). The "localhost" literal was repeated in the default config and the non-localhost SSL heuristic; this satisfies goconst with no behavior change.

Upgrading

No configuration or API changes. DescribeTableInput is unchanged; include_sample=true behaves as before for text clients and now additionally fills the structured sample field. Drop-in upgrade from v1.3.0.

Changelog

Bug Fixes

• 0226bf9: fix(describe): surface include_sample rows in structured output (#574) (#71) (@cjimti)

Others

• 145dc72: ci: bump github/codeql-action in the github-actions group (#65) (@dependabot[bot])
• 57ab90a: ci: bump github/codeql-action in the github-actions group (#70) (@dependabot[bot])
• 77b7f5c: ci: bump goreleaser/goreleaser-action in the github-actions group (#60) (@dependabot[bot])
• 30393d5: ci: bump the github-actions group with 2 updates (#63) (@dependabot[bot])
• c18e85b: ci: bump the github-actions group with 2 updates (#64) (@dependabot[bot])
• 37439d2: ci: bump the github-actions group with 2 updates (#68) (@dependabot[bot])
• 5e35e2b: ci: bump the github-actions group with 3 updates (#59) (@dependabot[bot])
• af55e07: ci: bump the github-actions group with 5 updates (#67) (@dependabot[bot])
• 8551a30: deps: bump github.com/modelcontextprotocol/go-sdk (#62) (@dependabot[bot])
• 2aae58c: deps: bump github.com/modelcontextprotocol/go-sdk (#66) (@dependabot[bot])

Installation

Claude Desktop (macOS/Windows)

Download the .mcpb bundle for your platform and double-click to install:

• macOS Apple Silicon (M1/M2/M3/M4): mcp-trino_1.3.1_darwin_arm64.mcpb
• macOS Intel: mcp-trino_1.3.1_darwin_amd64.mcpb
• Windows: mcp-trino_1.3.1_windows_amd64.mcpb

Homebrew (macOS)

brew install txn2/tap/mcp-trino

Claude Code CLI

claude mcp add trino \
  -e TRINO_HOST=your-trino-host \
  -e TRINO_USER=your-user \
  -- mcp-trino

Docker

docker pull ghcr.io/txn2/mcp-trino:v1.3.1

Verification

All release artifacts are signed with Cosign. Verify with:

cosign verify-blob --bundle mcp-trino_1.3.1_linux_amd64.tar.gz.sigstore.json \
  mcp-trino_1.3.1_linux_amd64.tar.gz