Release v1.3.4

Altinity MCP Server v1.3.4

Release Notes

v1.3.4

FEATURES

• dynamic tools are now refreshed on every schema request (OpenAPI) or tools/list (MCP) call
• dynamic tools are now per-connection: different ClickHouse connections (user@host:port/database) have independent tool sets
• views deleted from ClickHouse are automatically removed from the tool list on next refresh

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.3.4 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.3.3

Altinity MCP Server v1.3.3

Release Notes

v1.3.3

IMPROVEMENTS

• change dynamic tools JSON comment format to {"name":"tool_name", "description":"tool description", "params": {"param1":"param1 description","param2":"description"}}

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.3.3 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.3.2

Altinity MCP Server v1.3.2

Release Notes

v1.3.2

FEATURES

• support JSON comments for rich dynamic tool descriptions
• append custom description to ClickHouse type in parameter details

TESTING

• add test for dynamic tools JSON comment parsing

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.3.2 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.3.1

Altinity MCP Server v1.3.1

Release Notes

v1.3.1

IMPROVEMENTS

• implement lazy loading for dynamic tools to improve startup time and reliability

BUG FIXES

• ensure dynamic tools are properly initialized when using JWE authentication by loading them upon first request with valid token

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.3.1 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.3.0

Altinity MCP Server v1.3.0

Release Notes

v1.3.0

FEATURES

• add dynamic tools support - automatically generate MCP tools from ClickHouse views, fix #27
  • configure rules to match views using regexp patterns against system.tables
  • optionally specify explicit tool names with name field (requires regexp to match exactly one view)
  • automatic parameter detection from view definitions {param: Type}
  • support for both MCP and OpenAPI endpoints
  • comprehensive documentation in docs/dynamic_tools.md

IMPROVEMENTS

• add Microsoft Copilot Studio compatibility by handling trailing slashes in HTTP paths (contribution by @derFunk)
• update dependencies:
  • bump github.com/mark3labs/mcp-go from 0.41.1 to 0.42.0
  • bump github.com/urfave/cli/v3 from 3.4.1 to 3.5.0
• update Helm chart values.yaml

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.3.0 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.2.1

Altinity MCP Server v1.2.1

Release Notes

v1.2.1

IMPROVEMENTS

• remove default limit behavior - LIMIT clause is now only added when explicitly specified by the user
• change --clickhouse-limit default from 1000 to 0 (no limit)
• --clickhouse-limit now acts as a maximum cap rather than a default value
• update OpenAPI documentation to clarify optional limit parameter behavior

BUG FIXES

• fix test expectations to match new limit behavior (expect 0 instead of 1000)

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.2.1 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.2.0

Altinity MCP Server v1.2.0

Release Notes

v1.2.0

IMPROVEMENTS

• remove list_tables and describe_table tools and resources
• remove all prompt capabilities

BUG FIXES

• fix OpenAPI schema generation to exclude removed endpoints
• remove references to deleted tools in documentation and tests
• extend isSelectQuery to support DESC, EXISTS, and EXPLAIN queries, fix #26

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.2.0 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.1.3

Altinity MCP Server v1.1.3

Release Notes

v1.1.3

BUG FIXES

• replace single quote and backtick chars to \uXXXX unicode representations in error message to avoid wrong MCP tool response handling in OpenAI, fix #19
• properly show version in OpenAPI spec and MCP protocol

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.1.3 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.1.2

Altinity MCP Server v1.1.2

Release Notes

v1.1.2

BUG FIXES

• add /openapi for SSE transport, even without JWE token, when JWE enabled, fix wrong config override from CLI to allow /openapi endpoint, even without JWE token, fix #15

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.1.2 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>

Release v1.1.1

Altinity MCP Server v1.1.1

Release Notes

v1.1.1

IMPROVEMENTS

• make --jwt-secret-key optional to use JSON serialization+JWE encryption instead of JWT signing+JWE encryption, fix #25

Docker

docker run --rm ghcr.io/altinity/altinity-mcp:1.1.1 altinity-mcp --help

Helm

helm install altinity-mcp oci://ghcr.io/altinity/altinity-mcp/helm/altinity-mcp -n <your-namespace> -f <your-values.yaml>