StarRocks MCP Server

StarRocks MCP Server

site icon
2025.03.09 0
Python数据库交互工具AI 模型接口数据库
StarRocks MCP Server 是一个用于与 StarRocks 数据库交互的模型控制协议(MCP)服务器。它提供了一个标准化的接口,使 AI 模型能够通过一组定义的工具查询和操作 StarRocks 数据库。
View on GitHub

Overview

基本能力

产品定位

StarRocks MCP Server 是一个数据库交互工具,专门为 AI 模型提供与 StarRocks 数据库的标准化接口。

核心功能

  • 执行 SELECT 查询
  • 列出可用表
  • 描述表结构
  • 创建新表(非只读模式下)
  • 执行写入操作(如 INSERT、UPDATE、DELETE,非只读模式下)

适用场景

  • AI 模型需要查询或操作 StarRocks 数据库的场景
  • 需要标准化接口进行数据库交互的开发项目

工具列表

  • read-query: 执行 SELECT 查询
  • list-tables: 列出所有表
  • describe-table: 描述表结构
  • write-query: 执行 INSERT、UPDATE 或 DELETE 查询(非只读模式下)
  • create-table: 创建新表(非只读模式下)

常见问题解答

使用教程

使用依赖

  • Python 3.8+
  • StarRocks 数据库实例
  • SQLAlchemy
  • MCP Python 库

安装教程

从源码安装

git clone https://github.com/yourusername/mcp-server-starrocks.git
cd mcp-server-starrocks
pip install -e .

从 Smithery 安装

npm install @smithery/sdk @modelcontextprotocol/sdk

使用 MCP Inspector

npx @modelcontextprotocol/inspector uv --directory ~/mcp-server-starrocks run mcp-server-starrocks

调试方式

启动服务器

python -m mcp_server_starrocks.server --host <starrocks-host> --port <starrocks-port> --user <username> --database <database-name> [--password <password>] [--readonly]

命令行参数

  • --host: StarRocks 服务器主机(必需)
  • --port: StarRocks 服务器端口(默认:9030)
  • --user: StarRocks 用户名(必需)
  • --database: StarRocks 数据库名称(必需)
  • --password: StarRocks 密码(如果需要)
  • --readonly: 以只读模式运行服务器(可选)

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。