Elevate MCP

提升MCP数据库工具

MCP（模型上下文协议）服务器，用于查询Elevate AB测试数据库。提供对MySQL（PlanetScale）和ClickHouse分析数据库的人工智能访问。

快速开始

选项1：连接到远程服务器（推荐）

如果你的团队已经部署了MCP服务器，只需配置你的AI客户端：

克劳德代码

添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "elevate-db": {
      "type": "sse",
      "url": "https://mcp.elevateab.com/sse",
      "headers": {
        "Authorization": "Basic "
      }
    }
  }
}

克劳德桌面版

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "elevate-db": {
      "type": "sse",
      "url": "https://mcp.elevateab.com/sse",
      "headers": {
        "Authorization": "Basic "
      }
    }
  }
}

光标

添加到光标设置（设置→ MCP服务器）：

{
  "elevate-db": {
    "type": "sse",
    "url": "https://mcp.elevateab.com/sse",
    "headers": {
      "Authorization": "Basic "
    }
  }
}

GitHub副本（VS代码）

Copilot中的MCP支持是实验性的。查看最新的配置文档。

______________________________________________________________________

选项2：本地安装

先决条件

• 转到1.21+或下载预构建的二进制文件
• 数据库凭据（请参阅 .env.example)

步骤1：安装MCP工具箱

选项A：通过Go安装

go install github.com/googleapis/genai-toolbox@latest

选项B：下载二进制文件

# Linux
wget https://github.com/googleapis/genai-toolbox/releases/latest/download/toolbox-linux-amd64 -O toolbox
chmod +x toolbox
sudo mv toolbox /usr/local/bin/

# macOS (Intel)
wget https://github.com/googleapis/genai-toolbox/releases/latest/download/toolbox-darwin-amd64 -O toolbox

# macOS (Apple Silicon)
wget https://github.com/googleapis/genai-toolbox/releases/latest/download/toolbox-darwin-arm64 -O toolbox

chmod +x toolbox
sudo mv toolbox /usr/local/bin/

步骤2：配置环境

cd databases/
cp .env.example .env
# Edit .env with your credentials

步骤3：运行服务器

# Using the wrapper script
./toolbox-wrapper.sh

# Or directly
toolbox --tools-file tools.yaml --address 0.0.0.0 --port 5000

步骤4：配置AI客户端

对于本地安装，请使用命令模式而不是SSE：

克劳德代码 (~/.claude/settings.json):

{
  "mcpServers": {
    "elevate-db": {
      "command": "toolbox",
      "args": ["--tools-file", "/path/to/databases/tools.yaml"]
    }
  }
}

克劳德桌面：

{
  "mcpServers": {
    "elevate-db": {
      "command": "/usr/local/bin/toolbox",
      "args": ["--tools-file", "/path/to/databases/tools.yaml"],
      "env": {
        "DB_USERNAME": "your-username",
        "DB_PASSWORD": "your-password",
        "CLICKHOUSE_USERNAME": "your-ch-username",
        "CLICKHOUSE_PASSWORD": "your-ch-password"
      }
    }
  }
}

______________________________________________________________________

可用工具

MySQL工具（27个工具）

ClickHouse分析工具（19个工具）

看 TOOLS.md 获取所有工具的详细文档。

______________________________________________________________________

使用示例

让克劳德查询数据

"Show me all active tests for mystore.myshopify.com"

"What's the conversion funnel for elevate-demo.myshopify.com last month?"

"Find orders from January 2025 with test variations"

"Compare device breakdown for our top 3 stores"

常见工作流程

检查商店健康状况：

1. Get store details: get_shop_by_id
2. List active tests: list_tests_by_store
3. Check conversion: ch_get_conversion_funnel
4. Review traffic: ch_get_daily_traffic

分析测试性能：

1. Get test info: get_test_by_id
2. Get variations: get_test_variations
3. Get analytics: ch_get_test_analytics
4. Compare variants: ch_get_test_variant_performance

______________________________________________________________________

文件

______________________________________________________________________

工具集和只读模式

使用包装脚本

这 toolbox-wrapper.sh 脚本自动加载 .env 并支持工具集：

# Run with all tools (default)
./toolbox-wrapper.sh

# Run in READ-ONLY mode (safe for production)
READ_ONLY=true ./toolbox-wrapper.sh

# Or set in .env file
# READ_ONLY=true

手动工具集选择

# Read-only (safe for production) - excludes execute, update tools
toolbox --tools-file tools.yaml --toolset readonly

# MySQL only
toolbox --tools-file tools.yaml --toolset mysql

# ClickHouse only
toolbox --tools-file tools.yaml --toolset clickhouse

# All tools (default)
toolbox --tools-file tools.yaml --toolset all

只读工具集

这 readonly 工具集不包括这些写入操作：

• execute -MySQL写操作
• ch_execute -ClickHouse写入操作
• update_test_status -测试状态更新

用于安全生产访问。

______________________________________________________________________

安全

• 永不承诺 .env -包含数据库凭据
• 使用只读工具集 用于生产查询
• 启用身份验证 通过URL公开时
• 限制IP访问 在生产部署中

看 部署.md 用于安全配置。

______________________________________________________________________

故障排除

连接被拒绝

# Check if server is running
curl http://localhost:5000/health

# Check environment variables
cat .env

数据库错误

# Test MySQL connection
mysql -h aws.connect.psdb.cloud -u $DB_USERNAME -p

# Test ClickHouse connection
curl "https://$CLICKHOUSE_HOST:8443/?query=SELECT%201"

未找到工具

确保tools.yaml位于正确的路径中，然后重新启动MCP服务器。

______________________________________________________________________

支持

• 文档： TOOLS.md
• 部署： 部署.md
• 问题：联系工程团队