hypequery MCP sunucusu
Commit 15 Kas 2026AI agent'larının tanımladığınız ClickHouse veri setlerini ve metriklerini listelemesine, şemaları incelemesine ve ham SQL yazmadan yönetilen analitik sorguları çalıştırmasına olanak tanıyın.
Ayrıca bilinen adı hypequery/hypequery, @hypequery/mcp, @hypequery/datasets
- Yıldızlar
- 106
- Araçlar
- —
- İndirmeler, 30 gün
- 108.251
- En son sürüm
- —
- Son commit
- 15 Kas 2026
- Lisans
- —
hypequery MCP nedir?
hypequery bir MCP sunucusudur. AI agent'larının tanımladığınız ClickHouse veri setlerini ve metriklerini listelemesine, şemaları incelemesine ve ham SQL yazmadan yönetilen analitik sorguları çalıştırmasına olanak tanıyın.
Özet, projenin README dosyasından oluşturuldu
hypequery MCP sunucusu hakkında
hypequery, AI agent'larının ClickHouse veri setleri üzerinde yönetilen analitikler gerçekleştirmesini sağlar. Bu MCP server, ham SQL için sınırsız erişim sağlamak yerine, kod tabanınızda tanımlanmış belirli boyutları, ölçüleri ve metrikleri sunar. Mühendisler, agent'ların yalnızca onaylanmış veri yapılarıyla etkileşime girmesini sağlamak için bunu kendi backend'leri içinde bir dizi Apache 2.0 kütüphanesi olarak dağıtabilirler.
Kullanıcılar, @hypequery/mcp paketini yükleyerek ve yerel bir yapılandırma dosyasıyla yapılandırarak sunucuyu entegre ederler. Kurulum tamamlandıktan sonra Claude Code veya Cursor gibi agent'lar; list_datasets, get_dataset_schema, query_metric ve query_dataset gibi özel araçları kullanabilirler. Bu kurulum, manuel SQL yazmaya gerek kalmadan tenant kurallarının ve metrik tanımlarının dashboard'lar, API'ler ve AI araçları arasında tutarlı kalmasını sağlar. Uygulama kodunuzla birlikte yaşayan bir semantik katmana ihtiyaç duyan TypeScript veya Python ile çalışan geliştiriciler için tasarlanmıştır.
Neler yapabilirsiniz
- 1Çoklu tenant güvenliğini koruyunSistem, veri sızıntısını önlemek için AI sorgularının kodunuzda tanımlanan tenant sınırlarına uymasını sağlar.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
hypequery MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklehypequery MCP'yi Claude Code içine yükleyin
$ claude mcp add hypequery -- npx -y @hypequery/mcphypequery MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"hypequery": {
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}hypequery MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"hypequery": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}hypequery MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"hypequery","type":"stdio","command":"npx","args":["-y","@hypequery/mcp"]}'hypequery MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"hypequery": {
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}hypequery MCP'yi Codex içine yükleyin
$ codex mcp add hypequery -- npx -y @hypequery/mcphypequery MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.hypequery] command = "npx" args = ["-y", "@hypequery/mcp"]
hypequery MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user hypequery npx -- -y @hypequery/mcphypequery MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"hypequery": {
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirhypequery/hypequery is public and reachablegithub.com/hypequery/hypequery ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@hypequery/mcp, @hypequery/datasets name hypequery/hypequery as sourcenpmjs.com/package/@hypequery/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/hypequery/hypequery ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @hypequery/mcp, @hypequery/datasetsGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Define your metrics once, in the codebase you already have. Dashboards, APIs, and AI agents all answer from that one definition. Run it in your own backend today. A hosted option, hypequery cloud, is coming soon.
hypequery is an open-source embedded analytics toolkit for ClickHouse that runs inside your own application. You define datasets in TypeScript or Python (beta), with their dimensions, measures, metrics, and tenant rules, then query them by name and serve them as authenticated HTTP endpoints with OpenAPI, typed React hooks, and MCP tools for AI agents. The TypeScript SDK also includes a type-safe ClickHouse query builder. It is for engineers building dashboards, APIs, and agent tools on their own ClickHouse. hypequery is not a hosted BI tool, not a database, and not a separate semantic-layer server: it is a set of Apache 2.0 libraries you install and deploy with your backend.
One definition, every surface
import { dataset, dimension, measure } from '@hypequery/datasets';
export const Orders = dataset('orders', {
source: 'orders',
tenantKey: 'tenant_id',
timeKey: 'created_at',
dimensions: {
region: dimension.string(),
status: dimension.string(),
createdAt: dimension.timestamp({ column: 'created_at' }),
},
measures: {
revenue: measure.sum('amount'),
orderCount: measure.count('id'),
p95OrderValue: measure.percentile('amount', 0.95),
},
});
export const revenue = Orders.metric('revenue', {
measure: 'revenue',
});
That dataset can run in a worker, become a validated HTTP endpoint, power a typed React dashboard, or appear as a bounded MCP tool. Tenant scope and metric meaning stay in one place.
Start in minutes (TypeScript)
npm install -D @hypequery/cli
npx hypequery init
npx hypequery dev
Or add only the ClickHouse query builder:
npm install @hypequery/clickhouse
const revenueByRegion = await db
.table('orders')
.select(['region'])
.where('status', 'eq', 'completed')
.sum('amount', 'revenue')
.groupBy('region')
.orderBy('revenue', 'DESC')
.execute();
No hand-written result interface. No any[]. The result is inferred from your real schema and the query itself.
Python (beta)
The Python SDK implements the same datasets and Serve protocol, checked against the same conformance fixtures. Serve it from FastAPI, Django, Flask, or any ASGI or WSGI server.
pip install "hypequery[clickhouse]==0.1.0b2"
from hypequery.datasets import Dataset, DatasetQuery, ExecutionContext, create_dataset_client, dimension, measure, tenant
from hypequery.execution import ClickHouseConnection, create_clickhouse_executor
orders = Dataset(
name="orders",
source="orders",
tenant_key="tenant_id",
dimensions={"country": dimension("string")},
measures={"revenue": measure.sum("amount")},
)
analytics = create_dataset_client(executor=create_clickhouse_executor(ClickHouseConnection.from_env()))
result = analytics.execute(
orders,
DatasetQuery(dimensions=("country",), measures=("revenue",)),
context=ExecutionContext(tenant=tenant("org_123")),
)
See the Python docs and python/hypequery.
ClickHouse MCP server
@hypequery/mcp is a governed ClickHouse MCP server for Claude Code, Cursor, Codex and other agents. Agents call list_datasets, get_dataset_schema, query_metric and query_dataset against the datasets and metrics you define; there is no raw SQL tool. To try it against the public ClickHouse playground in five minutes, install the packages, save the mcp-config.mjs from the quickstart, and add the server to your agent:
npm install @hypequery/mcp @hypequery/datasets @hypequery/clickhouse
claude mcp add clickhouse -- npx -y @hypequery/mcp --config "$PWD/mcp-config.mjs"
Built for product analytics
- ClickHouse-native: generated types plus
FINAL,LIMIT BY, percentiles,argMax, arrays, CTEs, streaming, and window expressions. - Governed in code: dimensions, measures, metrics, relationships, and time grains live beside your application.
- Multi-tenant by design: runtime tenant scope fails closed instead of relying on every query author to remember a filter.
- Frontend ready: typed TanStack Query hooks for named queries, metrics, and datasets.
- Agent ready: MCP tools expose approved analytics, not unrestricted SQL.
- Two languages, one contract: TypeScript and Python produce the same semantic and deployment artifacts.
- Easy to adopt: start with one local query and add the semantic, HTTP, React, or MCP layers only when needed.
Packages
| Package | Job |
|---|---|
@hypequery/clickhouse |
Type-safe ClickHouse query builder |
@hypequery/datasets |
TypeScript semantic layer |
@hypequery/serve |
Validated analytics APIs and OpenAPI |
@hypequery/react |
Typed React hooks |
@hypequery/mcp |
Governed ClickHouse MCP server |
@hypequery/cli |
Setup, generation, local docs, and deployment |
hypequery (PyPI) |
Python datasets, execution, Serve, and CLI (beta) |
Explore
- What hypequery supports today
- ClickHouse semantic layer
- Multi-tenant analytics
- React hooks
- MooseStack EOL comparison
- MooseStack migration guide
If hypequery saves you from another copied SQL string or drifting metric, a GitHub star helps the next team find it.
License
Apache-2.0. See LICENSE.
hypequery MCP soruları
hypequery MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add hypequery -- npx -y @hypequery/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
hypequery MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
hypequery ClickHouse MCP server, agent'lara hangi araçları sunar?
Agent'lar, tanımladığınız veri setleri ve metrikler üzerinde list_datasets, get_dataset_schema, query_metric ve query_dataset komutlarını çağırabilir. Ham SQL aracı bulunmamaktadır.
hypequery MCP server'ı Claude Code'a nasıl eklerim?
Paketleri yükleyin ve yapılandırma dosyanızla birlikte @hypequery/mcp adresini gösteren claude mcp add komutunu çalıştırın. Öncelikle herkese açık ClickHouse playground üzerinde deneyebilirsiniz.
hypequery MCP server, agent'ların rastgele SQL yazmasına izin verir mi?
Hayır. Sadece onaylanmış analitik veri setleri ve metrikler sınırlandırılmış araçlar olarak sunulur.
MCP sorguları için tenant scoping uygulanıyor mu?
Evet, tenant kapsamı çalışma zamanında uygulanır; her sorgu yazarının filtre eklemesine güvenmek yerine, yetkisiz erişim durumunda işlem başarısız olur.
hypequery MCP server hangi agent'lar ile çalışır?
Claude Code, Cursor, Codex ve diğer agent'lar için tasarlanmıştır.