{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d7jyum456tqe","handle":"chdb-mcp","url":"https://wellknown.network/agents/chdb-mcp","links":{"self":"https://wellknown.network/agents/chdb-mcp/record.json","html":"https://wellknown.network/agents/chdb-mcp","markdown":"https://wellknown.network/agents/chdb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/chdb-mcp","status":"https://wellknown.network/api/v1/agents/chdb-mcp/status","claim":"https://wellknown.network/agents/chdb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/chdb-mcp/claim.json","badge":"https://wellknown.network/agents/chdb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/chdb-mcp/history","tools":"https://wellknown.network/api/v1/agents/chdb-mcp/tools"},"ard":{"identifier":"urn:air::server:chdb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"chdb-mcp","summary":"MCP server for chDB — the in-process SQL OLAP engine powered by ClickHouse. Lets AI agents query Parquet, CSV, JSON, and pandas DataFrames with one tool.","description":"# chdb-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/chdb-mcp.svg)](https://pypi.org/project/chdb-mcp/)\n[![CI](https://github.com/chdb-io/chdb-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/chdb-io/chdb-mcp/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n[![Python](https://img.shields.io/pypi/pyversions/chdb-mcp.svg)](https://pypi.org/project/chdb-mcp/)\n\nAn [MCP](https://modelcontextprotocol.io) server for [chDB](https://chdb.io), the in-process SQL OLAP engine powered by ClickHouse. Lets agents (Claude Desktop, Cursor, VS Code, Codex CLI, Cline, …) query Parquet, CSV, JSON, and pandas DataFrames with one tool — no separate server, no Docker.\n\n## Why chdb-mcp?\n\n- **Full ClickHouse engine, in-process.** 1000+ functions (`windowFunnel`, `quantilesTDigest`, `geoToH3`, the `-If`/`-State`/`-Merge` combinators), typed `JSON` with O(1) sub-column reads, native vectors, `MergeTree` storage.\n- **Drop-in pandas API.** `import datastore as pd` covers ~300 pandas-shaped methods compiled to ClickHouse SQL. v1.0 adds `dataframe_query()` for zero-copy `Python(df)`.\n- **~80 formats and 12+ source connectors in core.** Parquet, CSV, JSON, Avro, ORC, Arrow, Protobuf, plus `s3()`, `mongodb()`, `postgresql()`, `mysql()`, `iceberg()`, `deltaLake()` — no `INSTALL/LOAD` chain.\n- **Federate to remote ClickHouse in one statement.** (v0.5) `remoteSecure('cluster:9440', 'db.table', ...)` joins local Parquet with a production ClickHouse cluster in one optimised plan.\n- **Same SQL as your warehouse.** Copy-paste ClickHouse production queries into the agent prompt — no dialect bridge.\n\n## Install\n\n```bash\npip install chdb-mcp\n```\n\n## Connect\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{ \"mcpServers\": { \"chdb\": { \"command\": \"chdb-mcp\" } } }\n```\n\n**Cursor / VS Code** — same JSON in `~/.cursor/mcp.json`…","publisher":null,"homepage":"https://github.com/chdb-io/chdb-mcp#readme","repository":"https://github.com/chdb-io/chdb-mcp/releases","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["agent","ai","chdb","clickhouse","llm","mcp","olap"],"pricing":null,"endpoints":[{"url":"pypi:chdb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":0.733,"provenance":"derived"}],"categories":["data","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"chdb-mcp","registry":"pypi","observedAt":"2026-11-09T01:27:29.636Z","publishedAt":"2026-05-19T02:52:58.459814Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"chdb-mcp","url":"https://pypi.org/project/chdb-mcp/","firstSeenAt":"2026-09-09T11:30:12.364Z","fetchedAt":"2026-11-09T01:26:33.782Z","normalizedAt":"2026-11-09T01:26:33.782Z"}]},"firstSeenAt":"2026-09-09T11:30:12.364Z","updatedAt":"2026-11-09T01:27:29.636Z"}