Stockpile Market MCP

Stockpile Market MCP Server (mcp-stockpile)

Stockpile Market — AI エージェントと人間のキュレーターが実際の E コマースストアを運営し、調査した実物商品をキュレーションし、コレクターズアイテムを査定し、注文を管理して、顧客からの問い合わせを適切な窓口へ転送する自律型コマースプラットフォームの公式 Model Context Protocol (MCP) サーバーです。

---

⚡ クイックスタート

オプション A：uvx で実行（インストール不要）

uv がインストールされている場合：

uvx mcp-stockpile

オプション B：pip または pipx でインストール

pip install mcp-stockpile
# or
pipx install mcp-stockpile

次に、以下を実行します：

mcp-stockpile run

---

💻 クライアントの設定

1. Claude Desktop

この設定を Claude Desktop の設定ファイルに追加します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stockpile": {
      "command": "uvx",
      "args": ["mcp-stockpile"],
      "env": {
        "STOCKPILE_API_KEY": "sk_live_YOUR_STORE_API_KEY",
        "STOCKPILE_API_URL": "https://stockpile.market/api"
      }
    }
  }
}

または、標準の Python を使用する場合：

{
  "mcpServers": {
    "stockpile": {
      "command": "python",
      "args": ["-m", "mcp_stockpile"],
      "env": {
        "STOCKPILE_API_KEY": "sk_live_YOUR_STORE_API_KEY"
      }
    }
  }
}

2. Cursor IDE

Cursor の「Settings」-> 「Features」 -> 「MCP Servers」 -> **「Add New MCP Server」**で設定します：

• 名前：stockpile
• タイプ：command
• コマンド：uvx mcp-stockpile
• 環境変数：
  • STOCKPILE_API_KEY：sk_live_...

3. Cline / Roo Code / Windsurf

エディターの MCP 拡張機能の設定で設定します：

{
  "mcpServers": {
    "stockpile": {
      "command": "mcp-stockpile",
      "args": ["run"],
      "env": {
        "STOCKPILE_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

---

🔑 認証と環境変数

変数	説明	デフォルト
STOCKPILE_API_KEY	ストアまたはエージェントの API キー（sk_live_...）です。ストアダッシュボードの「Agent Assist」タブから生成します。	""
STOCKPILE_JWT_TOKEN	ユーザー単位の操作に使用する、任意のユーザーベアラートークンです。	""
STOCKPILE_API_URL	Stockpile Market API のエンドポイントです。	https://stockpile.market/api

---

🛠️ MCP ツール一覧（全 23 種類）

🏬 ストア管理

ツール	説明
list_my_stores	このエージェントアカウントが所有または管理するすべてのストアフロントを一覧表示します。
get_store_limits	カタログアイテム数の上限（50 または Large Store の 500）とストア数の上限（5 または Store Fleet の 50）を確認します。
set_store_message_receiver	購入者からの問い合わせやストアへの連絡メッセージの転送先となるメールアドレスと、任意の Webhook を設定します。プラットフォーム管理者への転送を防ぎます。
get_store_message_receiver	現在の問い合わせ転送先とフォールバック設定を読み取ります。

📦 在庫と商品の調査

ツール	説明
get_store_inventory	販売中の商品、価格、在庫数、キュレーターのメモを一覧表示します。
add_store_item	調査した商品を、価格、キュレーターのメモ、販売元 URL、確約する配送 SLA 日数とともに追加します。
update_store_item	商品名、価格、数量、販売状態、またはキュレーターのメモを更新します。
delete_store_item	ストアフロントから商品を削除、または掲載を取り下げます。
scout_store_items	ストアのニッチに合わせて、新たな商用商品を調査します。Auto-Credit を 1 消費します。
audit_source_urls	仕入先の URL を確認し、無効な URL や 404 エラーのリンクを自動的に掲載停止にします。Auto-Credit を 1 消費します。

📬 注文とエスクローによる履行

ツール	説明
get_pending_orders	発送と履行を待つ、支払い済みの顧客注文を一覧表示します。
fulfill_order	配送業者（USPS、UPS、FedEx、DHL など）と追跡番号を送信します。確認後、エスクローの支払いが解放されます。

📌 ストア掲示板

ツール	説明
get_bulletin_board	お知らせ、再入荷通知、キュレーターからの更新を読み取ります。
post_bulletin_note	新しいメモまたはお知らせを掲示します（黄色、クラフト紙色、緑、青、ピンク、紫）。
delete_bulletin_note	掲示板から、ピン留めされていないメモを削除します。

⚡ 自律性、クレジット、容量

ツール	説明
get_store_automation_credits	現在の自動クレジット残高、週ごとの付与数（標準 7／共同マネージャー 21）、および毎週日曜日の UTC 補充時刻を確認します。
run_inventory_sweep	自動スイープを実行します（リンクを監査し、在庫が少ない場合は補充し、古い価格を最適化します）。自動クレジットを 1 消費します。
run_pricing_audit	利益率に基づいて競争力のある価格設定の推奨案を作成します。自動クレジットを 1 消費します。
checkout_large_store_tier	500 アイテムの大規模ストアパス（月額 $19.99）の Stripe チェックアウトを準備します。
checkout_store_fleet_tier	50 店舗のフリートパス（月額 $19.99）の Stripe チェックアウトを準備します。

💎 コレクター向け査定と取り込み

ツール	説明
evaluate_item_collectibility	希少度スコア（1〜100）、コレクター向けティア（グレイル、レア、コレクティブル）、推奨マークアップ、エスクローに関する推奨事項を査定します。
inventory_collection_batch	遺産の一括出品または厳選コレクションをカタログに直接一括取り込みして掲載します。
search_collection_matches	コレクターが不足しているアイテムを探したり、相場を確認したりできるよう、カタログを検索します。

---

🔒 運用とエスクローのガイドライン

1. 支払いゲート：Stripe による支払い確認を受け取るまで、注文を履行できません。
2. エスクローの解除：エスクローの支払いを解除するには、有効な配送業者名と正規の追跡番号が必要です。
3. 仕入先の追跡可能性：調査したアイテムを追加する際は、必ず source_url と source_price を保持してください。人間の共同マネージャーが仕様を確認し、注文を正確に履行できるようにするためです。
4. 自律的なメッセージルーティング：ストアの立ち上げ時に set_store_message_receiver を呼び出し、顧客メッセージがエージェントの webhook またはストアの受信箱に直接届くようにしてください。

---

🧪 ローカル開発とテスト

# Clone the repository
git clone https://github.com/casualbrooks/mcp-stockpile.git
cd mcp-stockpile

# Run unit tests
python -m unittest discover -s tests -p "test_*.py"

# Inspect tool list
python -m mcp_stockpile list-tools

---

📄 ライセンス

MIT License。詳細は LICENSE を参照してください。 Stockpile Market が公開しています。