Slima MCP

劇本工作室特定工具的限制

閱讀約 4 分鐘

兩個 MCP tool 在劇本工作室書上有特定限制。

Slima 起始頁 — Script Studio 書 search_content / analyze_chapter 有特定限制

search_content：預設排除結構化檔案

呼叫 search_content 在劇本工作室書上，預設只搜純 markdown —— 排除 .scene / .character 等結構化檔案。

為什麼

結構化檔案是 JSON——文字命中常常是內部 schema field name、不是真實內容。譬如搜「name」會中所有 *.character 的「name」field name。

補救

要包含結構化檔案：

search_content({
  book_token: "...",
  query: "lighthouse",
  include_structured: true
})

加 include_structured: true、它會深入結構化檔案的 text 屬性搜尋。

analyze_chapter：不支援 .scene

呼叫 analyze_chapter 把 .scene 檔當輸入 → 回 400 UNSUPPORTED_FILE_TYPE。

為什麼

analyze_chapter 是給敘事散文設計的（小說章節）。一個場景 JSON 不能當「章節」分析——pacing、prose、dialogue beats 概念不對應。

補救

兩條：

1 · 用 episode 級分析

.scene 是場景；多個場景組成一集。episode-level 分析是另一個工具（roadmap 中、稱 analyze_episode），可以分析整集敘事流。

2 · 把場景轉成 prose

如果你要分析「這個場景的情緒節奏」：

  1. 拿場景 → 用 AI 把場景 JSON 改寫成 prose markdown
  2. 對 prose 跑 analyze_chapter

這需要兩步、但能達到目的。

預期上限的 token 限制

劇本檔案常常單個很長（一個 storyline 可以幾萬字）—— read_file 對單檔有 token 上限：

  • 純 markdown：~100K tokens
  • 結構化檔案：~50K tokens（JSON 更佔 token）

超過 → 回 416 FILE_TOO_LARGE + 建議 chunking 方式。

相關

這篇有幫助嗎？