StarRocks MCP 服务器

一个用于与 StarRocks 数据库交互的模型控制协议 (MCP) 服务器。该服务器为 AI 模型提供了一个标准化的接口，通过一组定义的工具来查询和操作 StarRocks 数据库。

概述

StarRocks MCP 服务器允许 AI 模型执行以下操作：

• 在 StarRocks 数据库上执行 SELECT 查询
• 列出可用的表
• 描述表模式
• 创建新表（当不在只读模式下时）
• 执行写入操作，如 INSERT、UPDATE、DELETE（当不在只读模式下时）

安装

前提条件

• 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: 以只读模式运行服务器 (可选)

可用工具

服务器提供以下工具：

只读工具：

• read-query: 在 StarRocks 数据库上执行 SELECT 查询
• list-tables: 列出 StarRocks 数据库中的所有表
• describe-table: 描述特定表的模式

写入工具（当不在只读模式下时可用）：

• write-query: 执行 INSERT、UPDATE 或 DELETE 查询
• create-table: 在 StarRocks 数据库中创建一个新表

示例

列出表

{
    "name": "list-tables",
    "arguments": {}
}

执行 SELECT 查询

{
    "name": "read-query",
    "arguments": {
        "query": "SELECT FROM my_table LIMIT 10"
    }
}

描述表

{
    "name": "describe-table",
    "arguments": {
        "table_name": "my_table"
    }
}

创建表（当不在只读模式下时）

{
    "name": "create-table",
    "arguments": {
        "query": "CREATE TABLE new_table (id INT, name VARCHAR(100))"
    }
}

许可证

MIT 许可证

贡献

欢迎贡献！请随时提交 Pull Request。