{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6xa2f6pyp2ab","handle":"clickhouse-mcp-server","url":"https://wellknown.network/agents/clickhouse-mcp-server","links":{"self":"https://wellknown.network/agents/clickhouse-mcp-server/record.json","html":"https://wellknown.network/agents/clickhouse-mcp-server","markdown":"https://wellknown.network/agents/clickhouse-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/clickhouse-mcp-server","status":"https://wellknown.network/api/v1/agents/clickhouse-mcp-server/status","claim":"https://wellknown.network/agents/clickhouse-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/clickhouse-mcp-server/claim.json","badge":"https://wellknown.network/agents/clickhouse-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/clickhouse-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/clickhouse-mcp-server/tools"},"ard":{"identifier":"urn:air::server:clickhouse-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"clickhouse-mcp-server","summary":"A MCP server implementation for ClickHouse database integration","description":"# Clickhouse MCP server\n[![smithery badge](https://smithery.ai/badge/@burakdirin/clickhouse-mcp-server)](https://smithery.ai/server/@burakdirin/clickhouse-mcp-server)\n\nA Clickhouse database MCP server project.\n\n## Installation\n\nYou can install the package using `uv`:\n\n```bash\nuv pip install clickhouse-mcp-server\n```\n\nOr using `pip`:\n\n```bash\npip install clickhouse-mcp-server\n```\n\n## Components\n\n### Tools\n\nThe server provides two tools:\n- `connect_database`: Connects to a specific Clickhouse database\n  - `database` parameter: Name of the database to connect to (string)\n  - Returns a confirmation message when connection is successful\n\n- `execute_query`: Executes Clickhouse queries\n  - `query` parameter: SQL query/queries to execute (string)\n  - Returns query results in JSON format\n  - Multiple queries can be sent separated by semicolons\n\n## Configuration\n\nThe server uses the following environment variables:\n\n- `CLICKHOUSE_HOST`: Clickhouse server address (default: \"localhost\")\n- `CLICKHOUSE_USER`: Clickhouse username (default: \"root\") \n- `CLICKHOUSE_PASSWORD`: Clickhouse password (default: \"\")\n- `CLICKHOUSE_DATABASE`: Initial database (optional)\n- `CLICKHOUSE_READONLY`: Read-only mode (set to 1/true to enable, default: false)\n\n## Quickstart\n\n### Installation\n\n#### Claude Desktop\n\nMacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n\nWindows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n<details>\n  <summary>Development/Unpublished Server Configuration</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"clickhouse-mcp-server\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/Users/burakdirin/Projects/clickhouse-mcp-server\",\n        \"run\",\n        \"clickhouse-mcp-server\"\n      ],\n      \"env\": {\n        \"CLICKHOUSE_HOST\": \"localhost\",\n        \"CLICKHOUSE_USER\": \"root\",\n        \"CLICKHOUSE_PASSWORD\": \"password\",\n        \"CLICKHOUSE_DATABASE\": \"[optional]\",\n        \"CLICKHOUSE_READONLY\": \"true\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<de…","publisher":null,"homepage":"https://github.com/burakdirin/clickhouse-mcp-server","repository":"https://github.com/burakdirin/clickhouse-mcp-server/issues","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:clickhouse-mcp-server","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"}],"categories":["data"],"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":"clickhouse-mcp-server","registry":"pypi","observedAt":"2026-11-09T01:27:43.764Z","publishedAt":"2025-03-17T23:42:07.552229Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"clickhouse-mcp-server","url":"https://pypi.org/project/clickhouse-mcp-server/","firstSeenAt":"2026-09-09T11:31:00.282Z","fetchedAt":"2026-11-09T01:27:05.728Z","normalizedAt":"2026-11-09T01:27:05.728Z"}]},"firstSeenAt":"2026-09-09T11:31:00.282Z","updatedAt":"2026-11-09T01:27:43.764Z"}