Repository navigation
ContextGate 0.4.0 — Semantic Data Gateway for AI Agents
ContextGate 0.4.0
Semantic Data Gateway for AI Agents
Understand your business. Query data safely.
The first release under ContextGate, formerly MCP DB Hub. The repository is now SamuelSupe/contextGate; history and earlier releases remain available.
What's new
- Configuration MCP — 22 typed tools at
/mcp/configlet trusted Agents prepare sources, semantic catalogs, templates, ontologies and mappings. Dedicated expiring credentials, real read-only trials and administrator publication keep configuration and query access separate. - Graphical ontology editor — contextual entity/property/relationship editing, source mappings and template usage.
- Guided Agent setup — client configuration, readiness, lossless parameter forms, query previews and saved evaluation history.
- Operations — management audit and OTLP Logs, semantic publication history, restore-to-draft, health checks, regression cases, deployment diagnostics and backup verification.
- English-first presentation — new logo, product screenshots and documentation hub, with English/Chinese UI and help.
- PostgreSQL metadata and read-only/authentication hardening.
Installation and downloads
| Platform | Archive |
|---|---|
| Linux arm64 | contextgate-0.4.0-linux-arm64.tar.gz |
| Linux amd64 | contextgate-0.4.0-linux-amd64.tar.gz |
Verify the downloaded archive with SHA256SUMS. Keep the full extracted directory and launch ./contextgate; mcpdbhub remains an alias. Packages contain the embedded UI, private C++ libraries, bilingual help, examples and dependency notices. Requires glibc ≥ 2.36 and a PostgreSQL metadata database. Docker Compose is available in the source repository for Docker/OrbStack users. No native macOS/Windows or Alpine/musl archive is included.
Breaking upgrade: metadata storage
0.4.0 does not import metadata from the SQLite store used by 0.3.0 and earlier. Back up the old metadata and matching key, initialize a fresh PostgreSQL store and administrator, recreate connections/grants, and update client tokens. Review/import semantic and ontology exports as drafts and rerun validation/trials. SQLite remains supported as a query data source. Existing MCPDBHUB_* configuration keys and telemetry attribute names are retained.
Read the upgrade checklist before switching.
Verified
- OrbStack: 18 products / 20 versions, 135 query/error cases, 104 denied operations, unchanged fixture data, seven query families with native/template equivalence and ontology mappings.
- Full Go tests and race checks; 10 frontend tests and production UI build.
- Native Linux arm64 and amd64 GitHub CI.
- Independently extracted packages: PostgreSQL initialization, HTTP/stdio queries, Configuration MCP, template/ontology workflows, restart, revocation, password recovery and OTLP HTTP/gRPC delivery.
- Published archives downloaded from GitHub and checked again before release publication; attached reports bind results to the source commit and archive SHA-256.
Local amd64 package execution uses OrbStack emulation on an arm64 host. The full database matrix runs on Linux arm64; it does not claim every database/version on both architectures.
Help
Documentation · Install · Getting started · Configuration MCP · Operations · 中文帮助 · Changelog