StarRocks数据库MCP服务

StarRocks MCP Server是一个为AI模型提供标准化接口的服务,用于查询和操作StarRocks数据库。

  • by hagsmand
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hagsmand/mcp-server-starrocks

使用说明

StarRocks MCP服务器

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

概述

StarRocks MCP服务器允许AI模型:

  • 在StarRocks数据库上执行SELECT查询
  • 列出可用表格
  • 描述表模式
  • 创建新表(非只读模式时)
  • 执行写入操作,如INSERT、UPDATE、DELETE(非只读模式时)

安装

先决条件

  • Python 3.8+
  • StarRocks数据库实例
  • SQL炼金术
  • MCP Python库

从源代码安装

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

从Smithery安装

npm安装@smithery/sdk@modelcontextprotocol/sdk

使用MCP检查器

npx@modelcontextprotocol/inspector uv--目录~/mcp服务器starrocks运行mcp服务器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许可证

贡献

欢迎投稿!请随时提交拉取请求。