Profitlee Mcp

profitlee-mcp

适用于 Profitlee 的 MCP 服务——可从任意 MCP 客户端（Claude Desktop、Claude Code、Cursor 等）计算精确到国家/地区的 Amazon FBA/FBM 和 TikTok Shop 利润率，并管理已保存的方案。

calculate_profit 免费且无需令牌。方案工具需要 Profitlee Pro API 令牌。

MCP 注册表名称：io.github.AronLEEdev/profitlee-mcp

快速开始

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "profitlee": {
      "command": "npx",
      "args": ["-y", "profitlee-mcp"],
      "env": {
        "PROFITLEE_API_TOKEN": "eck_live_xxx"
      }
    }
  }
}

PROFITLEE_API_TOKEN 可选——若只使用 calculate_profit，可省略整个 env 区块。请在 Profitlee 的账户页面创建令牌，以使用方案工具。

需要 Node.js 20+。

工具

工具	身份验证	描述
calculate_profit	无	完整的单件成本明细、毛利率/净利率和月度损益。
list_scenarios	Pro 令牌	列出已保存的方案。
get_scenario	Pro 令牌	按 ID 查看一个方案（输入 + 输出）。
save_scenario	Pro 令牌	根据计算器输入保存一个命名方案。
update_scenario	Pro 令牌	重命名方案和/或替换方案输入。
delete_scenario	Pro 令牌	按 ID 删除方案。
copy_scenario	Pro 令牌	将方案复制为一个新方案（“Copy of …”）。

calculate_profit 输入

选择 platform + mode，提供产品的实体属性和成本详情，Profitlee 会将所有费用合并计算为单一净利率。费率使用 0–1 的小数（例如，0.15 = 15%）。美国使用英寸 + 磅；德国/日本使用厘米 + 千克。

字段	说明
platform	amazon（默认）或 tiktok_shop。
region	us、de 或 jp。
mode	amazon：fba | fbm。tiktok_shop：fbt | self_fulfilled。
L、W、H、weight	尺寸 + 单件重量。
fob、headShip、duty	单件成本、单件头程运费、单件进口关税。
price	售价（总价；德国/日本含 VAT）。
ppcAcos、returnRate	广告 ACoS 和退货率（0–1）。
monthlyVolume	每月件数（用于按比例计算损益）。
referralPct	推荐费（0–1）。优先于 referralCategory。
isApparel	会影响部分费用。
按模式区分	FBA：inboundOption、storageMonths、storageSeason。FBM / TikTok 自履约：outboundShipPerUnit、pickPackPerUnit、monthly3plStorage。TikTok FBT：storageMonthsPastFree。

验证以 Profitlee API 为准——输入不完整或超出范围时，会返回列明有问题字段的清晰错误信息。完整字段参考：https://profitlee.com/docs/api。

环境变量

变量	必需	默认值	用途
PROFITLEE_API_TOKEN	否	—	Pro 令牌（eck_live_…）；仅方案工具需要。
PROFITLEE_BASE_URL	否	https://profitlee.com	覆盖 API 源地址（用于测试）。

工作原理

此服务是对 Profitlee 公共 HTTP API 的轻量封装：

• calculate_profit → POST /api/v1/calculate（公开，无需令牌）。
• 方案工具 → /api/v1/scenarios*（需要 Pro 令牌；若未提供，服务会立即失败并显示清晰提示）。

这里不会重新实现任何费用逻辑，因此结果始终与 Profitlee 在线计算器及当前费用表一致。

开发

npm install
npm test       # vitest (27 tests)
npm run build  # tsc -> dist/
npm run dev    # run from source with tsx

发布

维护者：npm 发布和 MCP 注册表步骤请参阅 PUBLISHING.md。注册表清单位于 server.json。

许可证

MIT