
2026/05/29 0:05
Show HN: Ktx – データエージェント用のオープンソース実行可能コンテキストレイヤー
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
KTX は、AI エージェントが承認済みのメトリック定義、結合可能なカラム、および組み込みのビジネス知識を活用してデータウェアハウスを正確にクエリできるよう教導する自己向上型のコンテキストレイヤーです。Notion や dbt などのソースから企業の知識を自動的に学習し、データスタックをマッピングしてセマンティック層を構築、実行時にエージェントへ提供することで、手動のメンテナンスや標準 LLM サブスクリプションを超える追加の使用量課金を不要にします。汎用的なエージェントがデータタスクで苦戦するのと対照的に、KTX はウィキコンテンツを取り込んでコンテキストを整備し、重複を除去し、矛盾箇所をレビューのためにフラッグします。メタデータと使用パターンをキャプチャし、結合可能なカラムを検出するとともに、シャスムトラップやファントラップなどの複雑なスキーマ問題を自動的に解決し、宣言的なメトリック取得を実現します。CLI ツールおよび MCP ツールの両方を暴露するため、ウィキコンテンツとセマンティック層エンティティを対象とした全文検索とセマンティック検索を組み合わせた機能を備えています。KTX は、エージェント(例:Claude Code、Cursor)が承認済みの定義でデータウェアハウスをクエリしたり、正則な SQL を再利用してゼロから新しいクエリを発明する必要がないことを望むユーザーに強く推奨されます。インストールは
npm install -g @kaelio/ktx で行われ、その後に ktx setup で構成し、ktx status でステータスを確認します。プロジェクト構成には ktx.yaml(コンフィグ)、semantic-layer/(YAML ソース)、wiki/(コンテキスト)、.ktx/(ローカル状態、git 無視)が含まれます。ホストサービスは必要なく、ローカルの MCP デモンは ktx mcp start でオンデマンドで起動します。PostgreSQL、Snowflake、BigQuery、ClickHouse、MySQL、SQL Server、SQLite の主要なデータベースおよび dbt、MetricFlow、LookML、Looker、Metabase、Notion などのスタックと互換性があります。ローカルで読み取り専用データベース接続を介して動作するため、データウェアハウスへの書き込みは行わず、Anthropic API、Google Vertex AI、AI Gateway、そしてローカルの Claude Code セッションなどの AI プロバイダーをサポートします。
Text to translate:
KTX is a self-improving context layer that teaches AI agents to query data warehouses accurately using approved metric definitions, joinable columns, and built-in business knowledge. It automatically learns company knowledge from sources like Notion and dbt, maps your data stack, builds a semantic layer, and serves agents at execution—eliminating the need for manual upkeep or extra usage billing beyond standard LLM subscriptions (works with your own LLM API keys or Claude Pro/Max). Unlike general-purpose agents that struggle with data tasks, KTX ingests wiki content to organize context, removes duplicates, and flags contradictions for review. It captures metadata and usage patterns, detects joinable columns, and resolves complex schema issues such as chasm traps and fan traps automatically, enabling declarative metric fetching. Exposing both CLI and MCP tools, it offers combined full-text and semantic search across wiki content and semantic-layer entities. KTX is highly recommended for users wanting agents (e.g., Claude Code, Cursor) to query warehouses with approved definitions or reuse canonical SQL instead of inventing new queries from scratch. Installation is done via
npm install -g @kaelio/ktx, followed by configuration with ktx setup and status checks using ktx status. The project layout includes ktx.yaml for config, semantic-layer/ for YAML sources, wiki/ for context, and .ktx/ for local state (git-ignored). No hosted service is required; the local MCP daemon runs on demand via ktx mcp start. It works with major databases including PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, SQL Server, and SQLite, and integrates with stacks like dbt, MetricFlow, LookML, Looker, Metabase, and Notion. Running locally with read-only database connections, KTX never writes to the warehouse and supports AI providers such as Anthropic API, Google Vertex AI, AI Gateway, and local Claude Code sessions.本文
ktx: 自発的に改善されるコンテキスト層
ktx は、承認済みの指標定義、結合可能な列、そして組織のビジネス知識に基づいて、エージェントにデータを正確に照会させる方法を教えるために設計されています。これにより、従来の意味層(Semantic Layer)や汎用型エージェントの問題点を自動で解決します。
注意:
を使用する際は、ご自身の LLM API キーまたは Claude Pro/Max サブスクリプションをご利用ください。追加の利用料はかかりません。ktx
なぜ ktx か
汎用型エージェントはデータ関連のタスクにおいて、倉庫を再探索したり、独自ロジックで数値を返すなどの課題を抱えています。
ktx は以下を自動的に実行します:
- 組織の知識から学習: Wiki の内容を整理し、矛盾箇所をフラグ立てて人間レビューに回します。
- データスタックのマッピング: テーブルメタデータを捕捉し、結合可能な列を検出、注釈を追加します。
- 意味層の自動構築: 生データと上位指標を組み合わせたジョイングラフにより、シャズムトラップやファントラップを解決し、標準 SQL を宣言的に取得できます。
- 実行時のサービス提供: Wiki と意味論的検索を組み合わせた CLI および MCP ツールを公開します。
ktx の比較機能
| 機能 | 汎用型エージェント | 従来の意味層 | ktx |
|---|---|---|---|
| 倉庫コンテキストの自動構築 | × | × | ✓ |
| 結合可能な列検出+トラップ解決 | × | 手動 | ✓ |
| 承認済み・再利用可能な指標定義 | × | ✓ | ✓ |
| Wiki/Notion/チーム知識の取り込み | × | × | ✓ |
| ソース間の矛盾フラグ立て | × | × | ✓ |
| エージェント実行用 CLI+MCP | 一部 | × | ✓ |
| デザイン上読み取り専用 | なし | なし | ✓ |
ktx は誰のためのものか
ご利用の対象者
- クラウドエージェント(Claude Code, Codex, Cursor, OpenCode など)が、承認済みの指標定義を使って倉庫を照会したい方。
- ビジネス知識が dbt、Looker、Metabase、Notion、およびチームの Wiki に散在している方。
- エージェントに各プロンプトごとではなく、標準 SQL の再利用を望む方。
ご導入をご検討の皆様
- SQL ウェアハウスを持っていない方(
はその上層に動作します)。ktx - アドホックなクエリのみが必要な場合(psql またはノートブックで対応可能です)。
互換性のあるデータベース: PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, SQL Server, SQLite。
連携可能なツールの指標層: dbt, MetricFlow, LookML, Looker, Metabase, Notion。
クイックスタート
環境構築と設定を行うための初歩的なコマンドです。
npm install -g @kaelio/ktx ktx setup ktx status
セットアップ概要
ktx setup コマンドは以下の処理を行います:
- ローカルな
プロジェクトの作成または再開ktx - プロバイダーへの接続構成
- コンテキストの構築
- エージェントとの統合インストール
ktx status
の出力例
ktx statusktx project: /home/user/analytics Project ready: yes LLM ready: yes (claude-sonnet-4-6) Embeddings ready: yes (text-embedding-3-small) Databases configured: yes (warehouse) Context sources configured: yes (dbt_main) ktx context built: yes Agent integration ready: yes (codex:project)
ヒント: すでにエージェントをご利用の方、プロジェクトディレクトリから Claude Code、Codex、Cursor、または OpenCode に
を実行してください。これによりnpx skills add Kaelio/ktx --skill ktxスキルをインストールおよび構成できます。ktx重要:
の出力にktx statusが表示された場合は、エージェントクライアントを開く前に必ずそのコマンドを実行してください。ktx mcp start --project-dir ...
主要コマンド一覧
| コマンド | 用途 |
|---|---|
| プロジェクトの作成、再開、または更新 |
| プロジェクトの準備状態の確認 |
| 設定された接続ごとのコンテキスト構築 |
| 意味論的ソース(指標)の検索 |
| ローカル Wiki ページの検索 |
| エージェント用 MCP サーバーの起動 |
詳細なオプションについては CLI リファレンス をご参照ください。
プロジェクトの構造
基本的なディレクトリ構成は以下の通りです。
my-project/ ├── ktx.yaml # プロジェクト設定(コミット対象外) ├── semantic-layer/<connection-id>/ # YAML 形式の意味論的ソース ├── wiki/global/ # シェアされたビジネスコンテキスト ├── wiki/user/<user-id>/ # ユーザー固有のノート ├── raw-sources/<connection-id>/ # インゲストされたデータおよびレポート └── .ktx/ # ローカル状態および機密情報(.gitignore に設定)
- コミット対象外:
,ktx.yaml
,semantic-layer/wiki/ - ローカールーム:
は必ずローカルに残してください。.ktx/
プロジェクトの解決順序
スクリプトで使用する場合、以下の優先順位で解決されます:
環境変数KTX_PROJECT_DIR- 最も近い
ファイルktx.yaml - 現在のディレクトリ
スクリプトでの使用時は、必ず
--project-dir <パス> を引数に渡してください。
FAQ(よくある質問)
Q: ktx はスキーマまたはクエリ結果をホストされたサービスに送信しますか?
A: いいえ。
はローカルで動作します。データが外部へ移動するのは、設定した LLM プロバイダーへ送信する分だけです。ktx
Q: どの LLM バックエンドに対応していますか? A: Anthropic API, Google Vertex AI, AI Gateway、および Claude Agent SDK を介した ローカルの Claude Code セッションに対応します。(詳細:LLM 構成)
Q: ktx と dbt や MetricFlow の意味層の違いは何ですか? A:
ktx はそれらの意味層を読み込み、生データのテーブルへの内省と Wiki コンテンツを組み合わせます。エージェントは複数の断片的な情報源ではなく、1 つの統合された検索可能表面を得られ、またソース間の矛盾もフラグ立ててくれます。
Q: ktx は実行中のサーバーが必要ですか? A: ホストされたサービスはありません。エージェントクライアントが必要とする時だけ、
ktx mcp start を通じてオンデマンドで ローカルの MCP デーモンが起動します。
Q: ウェアハウスは安全ですか? A: はい。接続は読み取り専用であり、
ktx はデータベースに書き込むことはありません。
ドキュメント一覧
- クイックスタート
- コンテキスト層
- コンテキストの構築
- CLI リファレンス
- エージェントクイックスタート
- コミュニティとサポート
- Telemetry
コミュニティとサポート
- Slack: 質問をしたり、構築された成果を共有したり、維持者と一緒にチャットしたりできます。
- GitHub Issues: バグ報告や機能リクエストを受け付けています。
- コントリビューション: リポジトリのセットアップ、テスト実行、および PR の公開が可能です。
開発環境での構築
以下のコマンドを実行することで、開発環境を構築できます。
git clone https://github.com/kaelio/ktx.git cd ktx pnpm install uv sync --all-groups pnpm run build pnpm run check
ktx は pnpm と uv を使用したワークスペースです。主要なモジュール構成は以下の通りです:
| パス | 目的 |
|---|---|
| TypeScript CLI および公開される npm パッケージのソース |
| コアコンテキストエンジン |
| LLM と埋め込みプロバイダー |
| データベーススキャンコネクタ |
| 意味論的層クエリ計画 |
| ポータブルコンピューティングサービス |
ローカル開発用 CLI
pnpm run setup:dev pnpm run link:dev ktx-dev --help
便利なチェックコマンド
- 型チェック:
pnpm run type-check - テスト実行:
pnpm run test - デッドコード検出:
pnpm run dead-code - Pytest 実行:
uv run pytest -q
テレメトリ(利用状況)
ktx は、インタラクティブな CLI の実行から、以下の目的で匿名の利用テレメトリを収集します:
- セットアップの改善
- コマンドの信頼性向上
- データエージェントワークフローの強化
記録されない情報: ファイルパス、ホスト名、SQL、スキーマ名、エラーメッセージ、または
argv は記録されません。イベントカタログとオプトアウトオプションについては詳細をご覧ください。
ライセンス
ktx は Apache License Version 2.0 のライセンス条項に従っています。LICENSE ファイルをご参照ください。