MCP Services - Timeplus MCP Server

简介

Timeplus MCP 服务器允许您通过 Claude 直接与 Timeplus 数据平台交互，执行 SQL 查询并管理流数据。

安装与配置

确保已安装 uv（安装指南）

配置 Claude Desktop：

# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置（替换尖括号内的值）：

{
  "mcpServers": {
    "mcp-timeplus": {
      "command": "uvx",
      "args": ["mcp-timeplus"],
      "env": {
        "TIMEPLUS_HOST": "<timeplus-host>",
        "TIMEPLUS_PORT": "<timeplus-port>",
        "TIMEPLUS_USER": "<timeplus-user>",
        "TIMEPLUS_PASSWORD": "<timeplus-password>",
        "TIMEPLUS_SECURE": "false",
        "TIMEPLUS_READ_ONLY": "false"
      }
    }
  }
}

重启 Claude Desktop

主要功能

提示增强

generate_sql：帮助 LLM 生成适合 Timeplus 的 SQL 查询

工具

工具	描述	参数
`run_sql`	执行 SQL 查询	`sql`: SQL 查询字符串
`list_databases`	列出所有数据库	无
`list_tables`	列出指定数据库中的表	`database`: 数据库名称
`list_kafka_topics`	列出 Kafka 主题	无
`explore_kafka_topic`	显示主题中的消息	`topic`: 主题名称 `message_count`: 消息数量(默认1)
`create_kafka_stream`	设置 Kafka 到 Timeplus 的 ETL	`topic`: 主题名称

高级配置

其他可选环境变量：

TIMEPLUS_VERIFY="true"
TIMEPLUS_CONNECT_TIMEOUT="30"
TIMEPLUS_SEND_RECEIVE_TIMEOUT="30"
TIMEPLUS_KAFKA_CONFIG={"bootstrap.servers":"example.com:28864", "sasl.mechanism":"SCRAM-SHA-256","sasl.username":"user", "sasl.password":"pass","security.protocol":"SASL_SSL"}

默认情况下，查询以只读模式运行。设置 TIMEPLUS_READ_ONLY="false" 以允许 DDL/DML 操作。

开发者说明

在本地运行测试服务器：

mcp dev mcp_timeplus/mcp_server.py