用途:在本地启动 ByteHouse MCP Server 并调用其 tools,用于连接 ByteHouse 数据库查询数据、通过 MCP 协议与 ByteHouse 交互,以及生成数据资产目录和血缘分析。
主要能力:提供 list_databases(列出所有数据库)、list_tables(列出指定数据库中的表)、run_select_query(运行 SELECT 查询)、run_dml_ddl_query(运行 DML/DDL 查询)、get_bytehouse_table_engine_doc(获取表引擎文档)等工具。data_asset_analyzer.py 可获取完整 schema、生成数据资产目录(表统计、引擎分布、自动标签、表资产详情)和血缘分析(表关系、列相似性)。
必要用法:前置条件为 Python 3.8+、uv 已安装在 /root/.local/bin/uv、配置 ByteHouse 连接信息。配置保存在 ~/.bytehouse_config.json,需用户提供 BYTEHOUSE_HOST 与 BYTEHOUSE_PASSWORD,BH_ARK_API_KEY 可选,仅在 embedding 时使用。测试 MCP Server:source scripts/export_config.sh,然后 uv run scripts/test_mcp_server.py。列出表:uv run test_list_tables.py。查询 Top 10 大表:uv run query_top10_tables_mcp.py。生成数据资产与血缘分析:uv run data_asset_analyzer.py,输出到 output/ 目录。服务管理脚本包括 ./start_mcp_service.sh、./status_mcp_service.sh、./stop_mcp_service.sh、./restart_mcp_service.sh。
适用场景与限制:适用于需要以 MCP 协议访问 ByteHouse、执行查询、盘点数据资产或分析血缘的任务。使用前需自行准备连接信息并按文档获取主机地址与密码;具体收费、价格与效果资料暂未提供。