项目简介: Triplewhale MCP Server 是一个 MCP 服务器实现，旨在将 Triplewhale 电商数据分析平台的功能桥接到支持 Model Context Protocol 的 LLM 客户端（如 Claude Desktop）。通过此服务器，用户可以使用自然语言与 LLM 交互，从而访问和分析他们的 Triplewhale 数据，例如查询广告支出、订单收入等电商指标。

主要功能点:

数据访问: 通过 'moby' 工具，允许用户使用自然语言查询 Triplewhale 平台上的电商数据。
工具集成: 集成了 'moby' 工具，该工具连接 Triplewhale API，提供数据查询功能。
易于安装: 提供使用 Smithery 或本地安装的简便安装方法。
Claude Desktop 支持: 专门为 Claude Desktop 设计，可以无缝集成。

安装步骤:

安装 Node.js: 确保你的系统中安装了 Node.js v18.0.0 或更高版本。
获取 Triplewhale API Key: 访问 Triplewhale 控制台 (https://app.triplewhale.com/api-keys) 创建并获取 API Key。

使用 Smithery 安装 (推荐 Claude Desktop 用户): 打开终端，运行命令：

npx -y @smithery/cli install triplewhale --client claude

本地安装: a. 克隆或下载仓库代码。 b. 在项目根目录运行 'npm install' 安装依赖。 c. 运行初始化命令，配置 Triplewhale API Key：
```
npx -y @triplewhale/mcp-server-triplewhale init YOUR_TRIPLEWHALE_API_KEY
```
将 'YOUR_TRIPLEWHALE_API_KEY' 替换为你的实际 API Key。 d. 重启 Claude Desktop (如果使用 Claude)。

服务器配置: MCP 客户端 (如 Claude Desktop) 需要以下配置信息来连接 Triplewhale MCP Server。此配置通常在客户端的 MCP 服务器设置中进行配置。对于 Claude Desktop，'init' 命令已经自动完成配置。以下是配置详情（无需手动配置，仅供参考理解）：

{
  "mcpServers": {
    "triplewhale": {
      "command": "npx",
      "args": ["-y", "@triplewhale/mcp-server-triplewhale", "start", "<YOUR_TRIPLEWHALE_API_KEY>"]
    }
  }
}

参数说明:

'server name': 'triplewhale' (服务器名称，用于客户端识别)
'command': 'npx' (启动命令，使用 npx 运行 npm 包)
'args': 启动参数列表
- '-y': 'npx' 参数，自动确认安装包
- '@triplewhale/mcp-server-triplewhale': MCP 服务器的 npm 包名，'npx' 会自动查找并执行该包
- 'start': Triplewhale MCP Server 的启动命令
- '<YOUR_TRIPLEWHALE_API_KEY>': 你的 Triplewhale API Key (请注意，实际配置中 API Key 在 'init' 步骤中配置，此处作为占位符说明)

基本使用方法:

确保 Triplewhale MCP Server 已成功安装并配置。
启动你的 MCP 客户端 (如 Claude Desktop)。
在客户端中，使用自然语言提出关于你的 Triplewhale 数据的查询，例如：
- 'Was my net profit positive last month?'
- 'Rank countries by order revenue and new users for the last quarter.'
- 'Give me ads ROAS over the last 7 days and break it out by attribution model?'

关键词

信息