项目简介

Tiger CLI是一个命令行工具,为Timescale Cloud平台提供数据库服务管理和查询功能。它内置了一个Model Context Protocol (MCP) 服务器,该服务器能够与Claude Code等AI助手集成,允许AI助手通过标准化的JSON-RPC协议访问和操作Timescale Cloud的基础设施。

该MCP服务器将CLI的功能抽象为可调用的工具 (Tools),如数据库服务管理和SQL查询执行。它还具备代理功能,可以从远程文档MCP服务器获取资源 (Resources)Prompt模板 (Prompts) 等上下文信息,为AI助手提供PostgreSQL、TimescaleDB和Tiger Cloud文档的语义搜索能力及操作指南。

主要功能点

  • 服务管理工具: 允许AI助手列出、获取、创建数据库服务,并更新服务密码。
  • 数据库操作工具: 允许AI助手执行SQL查询,支持参数化查询、自定义超时和连接池。
  • 文档和指南访问: 代理远程MCP服务器,提供对PostgreSQL、TimescaleDB和Tiger Cloud文档的语义搜索,以及针对TimescaleDB功能的综合指南和LLM交互模板。
  • 会话管理: 管理与AI助手客户端的交互会话。
  • 能力声明: 向客户端声明其提供的工具、资源和Prompt模板。
  • 多种传输协议: 支持Standard I/O (Stdio) 和可流式HTTP (Streamable HTTP) 协议进行通信。

安装步骤

Tiger CLI的安装方法多样,选择你偏好的方式。

  1. 安装脚本 (推荐) 在终端执行以下命令:
    curl -fsSL https://cli.tigerdata.com | sh
  2. Homebrew (macOS/Linux)
    brew install --cask timescale/tap/tiger-cli
  3. Debian/Ubuntu
    # 添加仓库
    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.deb.sh | sudo os=any dist=any bash
    # 安装 tiger-cli
    sudo apt-get install tiger-cli
  4. Red Hat/Fedora
    # 添加仓库
    curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.rpm.sh | sudo os=rpm_any dist=rpm_any bash
    # 安装 tiger-cli
    sudo yum install tiger-cli
  5. Go Install 如果你有Go环境,可以从源码安装:
    go install github.com/timescale/tiger-cli/cmd/tiger@latest

服务器配置

安装完成后,首先需要登录Timescale Cloud账户:

tiger auth login

然后,你可以配置MCP客户端以连接Tiger CLI的MCP服务器。大多数AI助手客户端需要一个JSON格式的配置,指定服务器的启动命令。

MCP客户端配置示例 (JSON)

{
  "mcpServers": {
    "tiger": {
      "command": "tiger",
      "args": [
        "mcp",
        "start"
      ]
    }
  }
}
  • 'mcpServers': 根对象,包含所有MCP服务器的配置。
  • 'tiger': 这是服务器的唯一标识符(名称),MCP客户端将使用此名称来引用Tiger MCP服务器。
  • 'command': 启动MCP服务器的程序名称。在这里是'tiger' CLI工具。
  • 'args': 传递给'command'的参数列表。'["mcp", "start"]' 表示执行 'tiger mcp start' 命令来启动MCP服务器。

说明

  • Stdio传输 (默认): 上述配置会通过Standard I/O (stdio) 传输协议启动MCP服务器。
  • HTTP传输: 如果你的MCP客户端需要HTTP传输,可以在'command'中添加'http --port <port>'。例如:
    {
      "mcpServers": {
        "tiger": {
          "command": "tiger",
          "args": [
            "mcp",
            "start",
            "http",
            "--port",
            "8080"
          ]
        }
      }
    }
    并确保MCP客户端配置使用 'http://localhost:8080' 作为URL。

配置完成后,请根据你的AI助手客户端的具体说明(通常是其设置界面)将此配置添加到客户端中,并重启你的AI助手以激活Tiger MCP服务器。

基本使用方法

一旦MCP服务器安装并配置到你的AI助手,AI助手就可以通过调用暴露的工具来与Timescale Cloud进行交互。

向AI助手提问示例:

  • "列出我的Timescale Cloud数据库服务"
  • "显示服务 'svc-12345' 的详细信息"
  • "创建一个名为 'my-new-app-db' 的数据库服务"
  • "更新数据库服务 'analytics-db' 的密码"
  • "在数据库服务 'data-warehouse' 上执行 SQL 查询 'SELECT COUNT(*) FROM sensor_data;'"
  • "根据超表 (hypertables) 概念,帮我优化PostgreSQL查询"
  • "给我关于TimescaleDB中数据保留策略的指南"

信息

分类

数据库与文件