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 を指定して、1 つのシナリオ（入力と出力）を読み込みます。
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%）。US ではインチとポンド、DE／JP では cm と kg を使用します。

フィールド	説明
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	販売価格（総額。DE／JP では 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