mcp-bytehouse 0.2.0__tar.gz

mcp_bytehouse-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+*config.yaml
+__pycache__/
+.idea
+.DS_Store
+.venv/
+*.egg-info/
+.env
+.vscode/
+.history/

mcp_bytehouse-0.2.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

mcp_bytehouse-0.2.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.5
+Name: mcp_bytehouse
+Version: 0.2.0
+Summary: An MCP server for ByteHouse.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: clickhouse-connect>=0.8.0
+Requires-Dist: mcp[cli]>=1.12.0
+Requires-Dist: pip-system-certs>=4.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: uvicorn>=0.34.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ByteHouse MCP Server
+
+An MCP server for ByteHouse. ByteHouse MCP Server serves as a communication bridge between large language models and ByteHouse instances, capable of efficiently transmitting information to achieve seamless docking and collaboration between the two. It also provides intelligent services throughout the entire life cycle for ByteHouse data development, query optimization, and cluster operation and maintenance. During data development, it offers precise guidance and suggestions to improve efficiency and quality. In terms of query optimization, it supports the analysis of statements and the optimization of performance. In the aspect of cluster operation and maintenance, it provides services such as monitoring the status, warning of risks, and automatic diagnosis and repair to ensure the efficient operation of the system.
+
+## Features
+
+### Tools
+
+* `run_select_query`
+  - Execute SQL queries on your ByteHouse cluster.
+  - Input: `sql` (string): The SQL query to execute.
+  - All ByteHouse queries are run with `readonly = 1` to ensure they are safe.
+
+* `list_databases`
+  - List all databases on your ByteHouse cluster.
+
+* `list_tables`
+  - List all tables in a database.
+  - Input: `database` (string): The name of the database.
+
+* `run_dml_ddl_query`
+  - Execute DML or DDL queries on your ByteHouse cluster.
+  - Input: `sql` (string): The SQL query to execute.
+
+## Configuration
+
+### Running the Server
+
+```bash
+# Run the server with stdio transport (default)
+mcp-bytehouse
+
+# Run the server with SSE transport
+mcp-bytehouse --transport sse
+```
+
+1. Open the Claude Desktop configuration file located at:
+   - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+2. Add the following:
+
+```json
+{
+  "mcpServers": {
+    "mcp-bytehouse": {
+      "command": "uvx",
+      "args": [
+            "--from",
+            "git+https://github.com/volcengine/mcp-server@main#subdirectory=server/mcp_server_bytehouse",
+            "mcp_bytehouse",
+      ],
+      "env": {
+        "BYTEHOUSE_HOST": "<ByteHouse-host>",
+        "BYTEHOUSE_PORT": "<ByteHouse-port>",
+        "BYTEHOUSE_USER": "<ByteHouse-user>",
+        "BYTEHOUSE_PASSWORD": "<ByteHouse-password>",
+        "BYTEHOUSE_SECURE": "true",
+        "BYTEHOUSE_VERIFY": "true",
+        "BYTEHOUSE_CONNECT_TIMEOUT": "30",
+        "BYTEHOUSE_SEND_RECEIVE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+## License
+
+This project is licensed under the Apache License.

mcp_bytehouse-0.2.0/README.md

@@ -0,0 +1,70 @@
+# ByteHouse MCP Server
+
+An MCP server for ByteHouse. ByteHouse MCP Server serves as a communication bridge between large language models and ByteHouse instances, capable of efficiently transmitting information to achieve seamless docking and collaboration between the two. It also provides intelligent services throughout the entire life cycle for ByteHouse data development, query optimization, and cluster operation and maintenance. During data development, it offers precise guidance and suggestions to improve efficiency and quality. In terms of query optimization, it supports the analysis of statements and the optimization of performance. In the aspect of cluster operation and maintenance, it provides services such as monitoring the status, warning of risks, and automatic diagnosis and repair to ensure the efficient operation of the system.
+
+## Features
+
+### Tools
+
+* `run_select_query`
+  - Execute SQL queries on your ByteHouse cluster.
+  - Input: `sql` (string): The SQL query to execute.
+  - All ByteHouse queries are run with `readonly = 1` to ensure they are safe.
+
+* `list_databases`
+  - List all databases on your ByteHouse cluster.
+
+* `list_tables`
+  - List all tables in a database.
+  - Input: `database` (string): The name of the database.
+
+* `run_dml_ddl_query`
+  - Execute DML or DDL queries on your ByteHouse cluster.
+  - Input: `sql` (string): The SQL query to execute.
+
+## Configuration
+
+### Running the Server
+
+```bash
+# Run the server with stdio transport (default)
+mcp-bytehouse
+
+# Run the server with SSE transport
+mcp-bytehouse --transport sse
+```
+
+1. Open the Claude Desktop configuration file located at:
+   - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+2. Add the following:
+
+```json
+{
+  "mcpServers": {
+    "mcp-bytehouse": {
+      "command": "uvx",
+      "args": [
+            "--from",
+            "git+https://github.com/volcengine/mcp-server@main#subdirectory=server/mcp_server_bytehouse",
+            "mcp_bytehouse",
+      ],
+      "env": {
+        "BYTEHOUSE_HOST": "<ByteHouse-host>",
+        "BYTEHOUSE_PORT": "<ByteHouse-port>",
+        "BYTEHOUSE_USER": "<ByteHouse-user>",
+        "BYTEHOUSE_PASSWORD": "<ByteHouse-password>",
+        "BYTEHOUSE_SECURE": "true",
+        "BYTEHOUSE_VERIFY": "true",
+        "BYTEHOUSE_CONNECT_TIMEOUT": "30",
+        "BYTEHOUSE_SEND_RECEIVE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+## License
+
+This project is licensed under the Apache License.

mcp_bytehouse-0.2.0/README_zh.md

@@ -0,0 +1,87 @@
+## MCP Server 产品名称
+ByteHouse MCP Server
+## 版本信息
+v25.4
+## 产品描述
+ByteHouse MCP Server有着不可替代的作用。它可以实现大语言模型（LLMs）与ByteHouse的高效协同。在数据开发方面，大语言模型能够根据开发者的自然语言描述生成相应的代码，而ByteHouse MCP Server则可以将这些代码准确地应用到ByteHouse实例中，避免了开发者手动编写代码时可能出现的错误和繁琐过程，大大提高了数据开发的效率。在查询优化环节，大语言模型可以分析查询需求和数据特点，提出优化建议，ByteHouse MCP Server则能将这些建议转化为实际的优化策略应用于ByteHouse实例，从而提升查询性能。对于集群运维，大语言模型可以预测潜在的问题和风险，ByteHouse MCP Server会及时将这些信息反馈给ByteHouse实例，并协助采取相应的措施进行预防和处理。
+## 分类
+大数据
+## 标签
+企业版，云数仓版，Search，智能助手
+
+## 产品视频
+<video src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lm_sth/ljhwZthlaukjlkulzlp/ark/mcpserverhub/readme_videos/bytehouse_mcp.mp4" controls>
+</video>
+
+## Tools
+本 MCP Server 产品提供以下 Tools (工具/能力):
+### list_database
+在进行数据管理和操作时，有时我们需要了解当前 ByteHouse 实例中所包含的数据库情况。此时，可以执行特定的查询操作，该工具操作的目的是查询当前 ByteHouse 实例下的所有数据库，通过此查询，系统将会返回该实例下存在的所有数据库。
+### list_tables
+查询当前ByteHouse实例中指定数据库下的所有数据表，并将查询到的所有数据表信息进行返回
+### run_select_query
+通过交互式执行 SELECT 查询语句来进行数据分析工作。在面对各种复杂的数据环境时，该助手能够精准地依据用户所提供的 SELECT 查询语句，在相应的数据库中进行数据检索操作，最终返回精确的查询结果。而且，更为重要的是，它不会仅仅止步于返回查询结果，还会对这些查询结果进一步进行全面且深入的分析说明。它会从多个维度去剖析这些数据，例如数据的分布规律、数据之间的关联关系、数据所反映出的潜在趋势等等，从而为用户提供更为详尽且有价值的信息，帮助用户更好地理解和利用这些数据。 
+### run_dml_ddl_query
+能够实现可交互地执行数据操作语言（DML）以及数据定义语言（DDL）的 SQL 语句。在使用者输入相关的 DML/DDL SQL 语句后，该助手会迅速对语句进行处理并执行，之后及时反馈执行结果，同时还会对执行结果给出详细的解释，帮助使用者更好地理解操作的过程和最终产生的影响。  
+## 最容易被唤起的 Prompt示例
+### list_database
+我想要查询当前所使用的集群环境中，都存在哪些数据库。具体来说，希望获取该集群内所有已创建数据库的名称等相关信息，以便进一步对这些数据库进行管理、分析或者使用等操作。 
+### list_tables
+我想要查询数据库名为 {database name} 的这个数据库中具体包含了哪些数据表。 
+### run_select_query
+帮忙查询一下集群存储目前的水位情况，包括各个存储节点当前的使用容量、剩余容量以及占总容量的百分比等详细信息。 
+## 可适配平台  
+火山方舟，Cursor，Visual Studio Code,Trae
+
+## 服务开通链接 (整体产品)  
+如下产品开通任意一个即可
+
+企业版： `https://console.volcengine.com/bytehouse-ce`     
+云数仓版： `https://console.volcengine.com/bytehouse`
+
+## 鉴权方式  
+用户开通Bytehouse企业版或Bytehouse云数仓版实例，在集群管理获取IP、端口、用户名、密码，并配置到MCP configure
+
+## 安装部署  
+如下已本地部署为例进行说明,操作系统macOS：
+
+### Setp 1
+在方舟平台开通大模型服务（豆包或DeepSeek),并获取API KEY
+
+### Setp 2
+本地安装Cursor，Visual Studio Code，Trae
+
+### Setp 3
+下载mcp-bytehouse安装包，执行如下命令运行mcp-bytehouse 服务 
+
+<font color="red"> ***注意！Python版本需要3.12***</font>
+
+```
+export BYTEHOUSE_HOST="<your_bytehouse_host>"
+export BYTEHOUSE_PORT="<your_bytehouse_port>"
+export BYTEHOUSE_USER="<your_bytehouse_user>"
+export BYTEHOUSE_PASSWORD="<your_bytehouse_password>"
+export BYTEHOUSE_SECURE="true"
+export BYTEHOUSE_VERIFY="true"
+export BYTEHOUSE_CONNECT_TIMEOUT="60"
+export BYTEHOUSE_SEND_RECEIVE_TIMEOUT="60"
+
+pip install -r requirements.txt
+python3 -m mcp_bytehouse.main -t sse
+```
+### Setp 4 
+本地cursor，Visual Studio Code，Trae 安装插件Cline
+
+### Setp 5
+Cline配置大模型地址及其API KEY,同时按照如下模版配置mcp configure
+```
+{
+  "mcpServers": {
+    "mcp_bytehouse":{
+        "url":"https://<your_hostname>:8000/sse"
+    }
+  }
+}
+```
+## License
+Apache License

mcp_bytehouse-0.2.0/mcp_bytehouse/__init__.py

@@ -0,0 +1,15 @@
+from .mcp_server import (
+    create_clickhouse_client,
+    list_databases,
+    list_tables,
+    run_select_query,
+    run_dml_ddl_query,
+)
+
+__all__ = [
+    "list_databases",
+    "list_tables",
+    "run_select_query",
+    "create_clickhouse_client",
+    "run_dml_ddl_query",
+]

mcp_bytehouse-0.2.0/mcp_bytehouse/main.py

@@ -0,0 +1,20 @@
+import argparse
+from .mcp_server import mcp
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Run the ByteHouse MCP Server")
+    parser.add_argument(
+        "--transport",
+        "-t",
+        choices=["sse", "stdio", "streamable-http"],
+        default="stdio",
+        help="Transport protocol to use (sse or stdio)",
+    )
+    args = parser.parse_args()
+
+    mcp.run(transport=args.transport)
+
+
+if __name__ == "__main__":
+    main()

mcp_bytehouse-0.2.0/mcp_bytehouse/mcp_env.py

@@ -0,0 +1,142 @@
+"""Environment configuration for the MCP ClickHouse server.
+
+This module handles all environment variable configuration with sensible defaults
+and type conversion.
+"""
+
+from dataclasses import dataclass
+import os
+from typing import Optional
+
+
+@dataclass
+class ClickHouseConfig:
+    """Configuration for ClickHouse connection settings.
+
+    This class handles all environment variable configuration with sensible defaults
+    and type conversion. It provides typed methods for accessing each configuration value.
+
+    Required environment variables:
+        BYTEHOUSE_HOST: The hostname of the ClickHouse server
+        BYTEHOUSE_USER: The username for authentication
+        BYTEHOUSE_PASSWORD: The password for authentication
+
+    Optional environment variables (with defaults):
+        BYTEHOUSE_PORT: The port number (default: 8443 if secure=True, 8123 if secure=False)
+        BYTEHOUSE_SECURE: Enable HTTPS (default: true)
+        BYTEHOUSE_VERIFY: Verify SSL certificates (default: true)
+        BYTEHOUSE_CONNECT_TIMEOUT: Connection timeout in seconds (default: 30)
+        BYTEHOUSE_SEND_RECEIVE_TIMEOUT: Send/receive timeout in seconds (default: 300)
+        BYTEHOUSE_DATABASE: Default database to use (default: None)
+    """
+
+    def __init__(self):
+        """Initialize the configuration from environment variables."""
+        self._validate_required_vars()
+
+    @property
+    def host(self) -> str:
+        """Get the ClickHouse host."""
+        return os.environ["BYTEHOUSE_HOST"]
+
+    @property
+    def port(self) -> int:
+        """Get the ClickHouse port.
+
+        Defaults to 8443 if secure=True, 8123 if secure=False.
+        Can be overridden by BYTEHOUSE_PORT environment variable.
+        """
+        if "BYTEHOUSE_PORT" in os.environ:
+            return int(os.environ["BYTEHOUSE_PORT"])
+        return 8443 if self.secure else 8123
+
+    @property
+    def username(self) -> str:
+        """Get the ClickHouse username."""
+        return os.environ["BYTEHOUSE_USER"]
+
+    @property
+    def password(self) -> str:
+        """Get the ClickHouse password."""
+        return os.environ["BYTEHOUSE_PASSWORD"]
+
+    @property
+    def database(self) -> Optional[str]:
+        """Get the default database name if set."""
+        return os.getenv("BYTEHOUSE_DATABASE")
+
+    @property
+    def secure(self) -> bool:
+        """Get whether HTTPS is enabled.
+
+        Default: True
+        """
+        return os.getenv("BYTEHOUSE_SECURE", "true").lower() == "true"
+
+    @property
+    def verify(self) -> bool:
+        """Get whether SSL certificate verification is enabled.
+
+        Default: True
+        """
+        return os.getenv("BYTEHOUSE_VERIFY", "true").lower() == "true"
+
+    @property
+    def connect_timeout(self) -> int:
+        """Get the connection timeout in seconds.
+
+        Default: 30
+        """
+        return int(os.getenv("BYTEHOUSE_CONNECT_TIMEOUT", "30"))
+
+    @property
+    def send_receive_timeout(self) -> int:
+        """Get the send/receive timeout in seconds.
+
+        Default: 300 (ClickHouse default)
+        """
+        return int(os.getenv("BYTEHOUSE_SEND_RECEIVE_TIMEOUT", "300"))
+
+    def get_client_config(self) -> dict:
+        """Get the configuration dictionary for BYTEHOUSE_connect client.
+
+        Returns:
+            dict: Configuration ready to be passed to BYTEHOUSE_connect.get_client()
+        """
+        config = {
+            "host": self.host,
+            "port": self.port,
+            "username": self.username,
+            "password": self.password,
+            "secure": self.secure,
+            "verify": self.verify,
+            "connect_timeout": self.connect_timeout,
+            "send_receive_timeout": self.send_receive_timeout,
+            "client_name": "mcp_bytehouse",
+        }
+
+        # Add optional database if set
+        if self.database:
+            config["database"] = self.database
+
+        return config
+
+    def _validate_required_vars(self) -> None:
+        """Validate that all required environment variables are set.
+
+        Raises:
+            ValueError: If any required environment variable is missing.
+        """
+        missing_vars = []
+        for var in ["BYTEHOUSE_HOST", "BYTEHOUSE_USER", "BYTEHOUSE_PASSWORD"]:
+            if var not in os.environ:
+                missing_vars.append(var)
+
+        if missing_vars:
+            raise ValueError(
+                f"Missing required environment variables: {', '.join(missing_vars)}"
+            )
+
+
+# Global instance for easy access
+config = ClickHouseConfig()