# 火山引擎 ByteHouse

查询数据库与表结构，执行数据查询及 DML、DDL 语句。

- 类型：MCP
- 权限：可执行操作
- 门槛：需授权账号、需 API Key
- 官方入口：https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/volc-bytehouse/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需 uv、可访问的 ByteHouse 实例和数据库账号；凭据权限、网络及实例费用按部署确认。

## 接入步骤

1. 按官方仓库准备实例主机、端口、账号密码与 TLS 设置。 [官方入口](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse)
2. 填入下方环境变量并用 uvx 启动 MCP，保留安全连接设置。 [官方入口](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse)

## 验证方法

只读查询数据库或表结构，核对实例；不执行 DDL、DML 验证连接。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "volc-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"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'BYTEHOUSE_HOST=${BYTEHOUSE_HOST}' --env 'BYTEHOUSE_PORT=${BYTEHOUSE_PORT}' --env 'BYTEHOUSE_USER=${BYTEHOUSE_USER}' --env 'BYTEHOUSE_PASSWORD=${BYTEHOUSE_PASSWORD}' --env 'BYTEHOUSE_SECURE=true' --env 'BYTEHOUSE_VERIFY=true' --transport stdio 'volc-bytehouse' -- 'uvx' '--from' 'git+https://github.com/volcengine/mcp-server@main#subdirectory=server/mcp_server_bytehouse' 'mcp_bytehouse'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.volc-bytehouse]
command = "uvx"
args = ["--from","git+https://github.com/volcengine/mcp-server@main#subdirectory=server/mcp_server_bytehouse","mcp_bytehouse"]
env_vars = ["BYTEHOUSE_HOST","BYTEHOUSE_PORT","BYTEHOUSE_USER","BYTEHOUSE_PASSWORD"]

[mcp_servers.volc-bytehouse.env]
BYTEHOUSE_SECURE = "true"
BYTEHOUSE_VERIFY = "true"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse)。火山引擎官方目录链接专用实现；pyproject 确认 mcp_bytehouse 启动名，含写入工具。

官方原文摘录（2026-11-05，来自上述依据）：

```
mcp_bytehouse
```

- [厂商官方接入文档](https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_bytehouse)
- [厂商官方发布依据](https://github.com/volcengine/mcp-server)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)