项目简介
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的安装方法多样,选择你偏好的方式。
- 安装脚本 (推荐)
在终端执行以下命令:
curl -fsSL https://cli.tigerdata.com | sh - Homebrew (macOS/Linux)
brew install --cask timescale/tap/tiger-cli - 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 - 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 - 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>'。例如:
并确保MCP客户端配置使用 'http://localhost:8080' 作为URL。{ "mcpServers": { "tiger": { "command": "tiger", "args": [ "mcp", "start", "http", "--port", "8080" ] } } }
配置完成后,请根据你的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中数据保留策略的指南"
信息
分类
数据库与文件