{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wv5wdcn8naqr","handle":"iflow-mcp-clickhouse-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-clickhouse-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-clickhouse-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-clickhouse-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-clickhouse-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-clickhouse-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-clickhouse-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_clickhouse-mcp-server","summary":"A Model Context Protocal (MCP) server that enables secure interaction with Clickhouse. This server allows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.","description":"# ClickHouse MCP Server\nA Model Context Protocal (MCP) server implement for ClickHouse.\n\nThis server provides AI assistants with a secure and structured way to explore and analyze databases. It enables them to list tables, read data, and execute SQL queries through a controlled interface, ensuring responsible database access.\n\n# Configuration\n\nSet the following environment variables:\n\n```bash\nCLICKHOUSE_HOST=localhost    \nCLICKHOUSE_PORT=8123         \nCLICKHOUSE_USER=default\nCLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD\nCLICKHOUSE_DATABASE=default\n```\n\nOr via command-line args:\n\n* `--host` the database host\n* `--port` the database port\n* `--user` the database username\n* `--password` the database password\n* `--database` the database name\n\n# Usage\n## Fake some data in clickhouse\nCheck the SQL in dev_contribute.md for details.\n## Post your question to AI assistant in Cline\n```\nWhat is the sales volume in each region? Which product is the best - selling?\n```\n<img src=\"pics/demo.png\" alt=\"Demo Screenshot\" width=\"600\" />\n\n## CLINE\n\nConfigure the MCP server in VSCode, Cline extension, or other MCP client.:\nExample:\n```json\n{\n  \"mcpServers\": {\n    \"clickhouse\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/clickhouse_mcp_server\",\n        \"run\",\n        \"-m\",\n        \"clickhouse_mcp_server.server\"\n      ],\n      \"env\": {\n        \"CLICKHOUSE_HOST\": \"localhost\",\n        \"CLICKHOUSE_PORT\": \"8123\",\n        \"CLICKHOUSE_USER\": \"default\",\n        \"CLICKHOUSE_PASSWORD\": \"CHANGE_TO_YOUR_PASSWORD\",\n        \"CLICKHOUSE_DATABASE\": \"default\"\n      }\n    }\n    \n  }\n}\n```\n\n# License\n\nAPACHE - See LICENSE file for details.\n\n# Contribute\nSee dev_contribute.md for details.\n\n## Prerequisites\n- Python with `uv` package manager\n- ClickHouse installation\n- MCP server dependencies\n\n# Acknowledgement\nThis library's implementation was inspired by the following three repositories and incorporates their code, respect for the open-source spirit!\n* [GreptimeTeam/grepti…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_clickhouse-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"}],"categories":["data","dev"],"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":"iflow-mcp_clickhouse-mcp-server","registry":"pypi","observedAt":"2026-11-09T08:24:19.070Z","publishedAt":"2025-10-30T03:58:02.067290Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_clickhouse-mcp-server","url":"https://pypi.org/project/iflow-mcp_clickhouse-mcp-server/","firstSeenAt":"2026-09-09T18:21:17.156Z","fetchedAt":"2026-11-09T08:22:16.467Z","normalizedAt":"2026-11-09T08:22:16.467Z"}]},"firstSeenAt":"2026-09-09T18:21:17.156Z","updatedAt":"2026-11-09T08:24:19.070Z"}