MCP 服务器

StarRocks MCP Server

作为 AI 助手和 StarRocks 数据库之间的桥梁，允许直接执行 SQL 语句和探索数据库，而无需复杂的设置或配置。

远程shell执行

数据库交互

数据与应用分析

访问服务器

README

Starrocks 官方 MCP 服务器

StarRocks MCP 服务器充当 AI 助手和 StarRocks 数据库之间的桥梁，允许直接执行 SQL 和探索数据库，而无需复杂的设置或配置。

配置

MCP 服务器配置

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-server-starrocks",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_HOST": "default localhost",
        "STARROCKS_PORT": "default 9030",
        "STARROCKS_USER": "default root",
        "STARROCKS_PASSWORD": "default empty"
      }
    }
  }
}

如果 mcp-server-starrocks 没有作为 python 包安装（在开发环境中），可以使用本地目录运行

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mcp-server-starrocks",
        "run",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_HOST": "default localhost",
        "STARROCKS_PORT": "default 9030",
        "STARROCKS_USER": "default root",
        "STARROCKS_PASSWORD": "default empty"
      }
    }
  }
}

组件

工具

read_query
- 执行 SELECT 查询或返回 ResultSet 的命令
write_query
- 执行 DDL/DML 或其他没有 ResultSet 的 StarRocks 命令

资源

直接资源

starrocks:///databases
- 列出 StarRocks 中的所有数据库

资源模板

starrocks:///{db}/{table}/schema
- 使用 SHOW CREATE TABLE 获取表的 schema
starrocks:///{db}/tables
- 列出特定数据库中的所有表
proc:///{+path}
- StarRocks 暴露的系统内部信息，类似于 linux /proc
- 常见的路径包括：
  - /frontends - 显示 FE 节点的信息
  - /backends - 如果此 SR 不是云原生部署，则显示 BE 节点的信息
  - /compute_nodes - 如果此 SR 是云原生部署，则显示 CN 节点的信息
  - /dbs - 显示数据库的信息
  - /dbs/<DB_ID> - 按数据库 ID 显示数据库的信息
  - /dbs/<DB_ID>/<TABLE_ID> - 按数据库 ID 显示表的信息
  - /dbs/<DB_ID>/<TABLE_ID>/partitions - 按数据库 ID 和表 ID 显示分区的信息
  - /transactions - 显示事务的信息
  - /transactions/<DB_ID> - 按数据库 ID 显示事务的信息
  - /transactions/<DB_ID>/running - 按数据库 ID 显示正在运行的事务的信息
  - /transactions/<DB_ID>/finished - 按数据库 ID 显示已完成的事务的信息
  - /jobs - 显示 job 的信息
  - /statistic - 显示每个数据库的统计信息
  - /tasks - 显示所有通用任务的总数和失败的任务
  - /cluster_balance - 显示负载均衡信息
  - /routine_loads - 显示 Routine Load 的信息
  - /colocation_group - 显示 Colocate Join 组的信息
  - /catalog - 显示 catalog 的信息