@marrowdev/cloud-mcp

Marrow の MCP サーバ。AI エージェントから web scrape / search / crawl / screenshot を 使えるようにする薄いクライアント。

作るより、使う方が安くて楽。 キャッシュ標準。

🛑 0.1.2 で監視レーンを取り下げました

抽出の設計を作り直すあいだ、変化監視・changeTracking・sections（と、その上に建っていた ローカル RAG 用の spool）を凍結しました。API は該当の呼び出しに 410 monitoring-withdrawn を返します。

• 監視ツール 4 本と spool オプションは、この版から道具一覧に出ません —— 押しても必ず失敗する道具を並べないため
• ⚠️ **0.1.1 以前を使っている場合、道具一覧には残っています。**押すと 410 が返ります （壊れたのではなく、取り下げです）
• ⚠️ **MARROW_SPOOL_DIR はもう読みません。**設定に残っていても黙って無視されます
• ⚠️ 凍結であって削除ではありませんが、いつ戻すかは決まっていません。 代わりのエンドポイントも別の format 名もありません（探さないでください）

API キー（mrw_...）は [marrow のダッシュボード] で発行（無料プランあり）。各 MCP クライアントの 設定に下のスニペットを貼って、MARROW_API_KEY を入れるだけ。

Install

各クライアントの設定ファイルに追記して再起動。サーバ実体はどれも同じ（npx -y @marrowdev/cloud-mcp + env）。

Claude Code (CLI)

claude mcp add marrow -e MARROW_API_KEY=mrw_xxx -- npx -y @marrowdev/cloud-mcp

Cursor / Claude Desktop / VS Code / Windsurf / Antigravity（JSON）

mcpServers に追記:

{
  "mcpServers": {
    "marrow": {
      "command": "npx",
      "args": ["-y", "@marrowdev/cloud-mcp"],
      "env": { "MARROW_API_KEY": "mrw_xxx" }
    }
  }
}

Codex CLI（TOML, ~/.codex/config.toml）

[mcp_servers.marrow]
command = "npx"
args = ["-y", "@marrowdev/cloud-mcp"]
env = { MARROW_API_KEY = "mrw_xxx" }

Tools

| tool | 説明 | 課金 | |---|---|---| | marrow_search | Web 検索＋精練 | 1 credit | | marrow_scout | 偵察（リンク・構造を高速抽出）。read の前に当たりを付けてトークン節約 | 0.5 credit | | marrow_read | URL を精読→clean markdown。⚠️ 通る formats は ["markdown"] のみ（changeTracking / sections は 410） | 1 credit（キャッシュヒットは 0.1） | | marrow_crawl | サイトを markdown 群に | 2 credit/page | | marrow_screenshot | フルページ PNG | 2 credit | | marrow_batch_scrape | 複数 URL 並列 | URL 数ぶん | | marrow_usage | 残量照会（プラン・クレジット・日次上限） | 無料 |

🛑 監視ツール 4 本（marrow_monitor_create / _list / _run / _delete）は 0.1.2 で外しました（上の節）。

失敗リクエストはクレジットを消費しません。

環境変数

| 変数 | 必須 | 既定 | |---|---|---| | MARROW_API_KEY | ✅ | — | | MARROW_API_URL | | https://api.marrow.navii.online |

⚠️ これは SaaS 線（edge 経由・API キーで課金）。社内/ローカルの worker 直結 MCP とは別物です。

Build（メンテナ向け）

bun install && bun run build   # → dist/index.js