Familiar MCP Server

官方

Foundry VTT 的 AI 副駕駛：透過與您的助手交談來

造訪 familiarvtt.com

文件

自備 AI，23 家供應商任選。專為 D&D 5e（2024）打造。

你的 Foundry VTT AI 副駕駛。

你買 Foundry 是為了幫大家主持遊戲。Familiar 站在地下城主這一邊：規則、骰子、怪物，每個 NPC 都有自己的聲音。所以你終於可以下場玩了。單人、一對一，或是一整團。

在 Foundry 中安裝加入 Discord

暫停

安裝

在 Foundry 中安裝 Familiar

Familiar 直接從 GitHub 發布。將這個網址貼到 Foundry 的安裝模組對話框。

清單網址：https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.json複製清單網址

  1. 在 Foundry 中，打開 設定 → 附加模組
  2. 點擊 安裝模組
  3. 將網址貼到底部的 清單網址 欄位，然後安裝。 顯示安裝模組對話框

Foundry VTT

v13、v14

遊戲系統

D&D 5e（2024 規則）：完整支援。其他系統可使用一般功能（聊天、日誌、場景、音訊），但不包含系統專屬工具，如角色卡或戰鬥自動化。

公開透明。發布在 npm 和 GitHub，問題在 Discord 上解答。

  • npmfamiliar-vtt
  • GitHub發行版
  • Discord隨意提問

自備 AI

連接你已經在使用的 AI。

貼上 API 金鑰，或將 Familiar 指向你已經付費的 Claude 或 ChatGPT 訂閱。兩種途徑都能使用相同的 193 個工具；差別在於模型在哪裡執行，以及你付錢給誰。

內建聊天

貼上 API 金鑰，開始與你的遊戲對話。

無需伺服器、終端機或設定檔。唯一在聊天基礎上提供語音、圖像生成和轉錄功能的路徑。思考控制項讓你能設定模型推理的強度，面對艱難戰鬥時調高，快速查詢時調低。

聊天（14 家供應商）

  • OpenRouter
  • Anthropic
  • OpenAI
  • Google
  • Groq
  • Mistral
  • Together AI
  • DeepSeek
  • xAI
  • Cohere
  • Perplexity
  • Fireworks AI
  • Cerebras
  • SambaNova

OpenRouter 用一組金鑰解鎖 300 多個模型。

語音（3 家供應商）

  • ElevenLabs
  • Cartesia
  • OpenAI TTS

圖像（3 家供應商）

  • OpenAI（GPT Image）
  • fal.ai
  • Leonardo AI

轉錄（3 家供應商）

  • Gladia
  • Deepgram
  • AssemblyAI

使用你的訂閱

已經付費使用 Claude、ChatGPT/Codex，或有 Google 帳戶？讓它發揮作用。

透過模型上下文協定連接，你現有的訂閱就能成為 DM 助手，無需額外 API 費用。模組內附 MCP 設定精靈，能偵測你的客戶端並產生設定檔供你貼上。最適合長時間、多步驟的任務鏈。你的模型及其推理強度是在你自己的客戶端中設定，而非在此處。

MCP 客戶端（7 家供應商）

  • Claude Desktop

  • Claude Code

  • Codex CLI

  • Codex Desktop

  • Antigravity CLI

  • Antigravity Editor

  • LM Studio

你的金鑰，你的成本。

大多數 AI 桌遊工具會透過他們的伺服器轉送、加價計算 token，並按回合向你收費。遊戲中途點數用完？那可真糟糕。Familiar 絕不代理或加價任何東西：你的 API 金鑰直接從瀏覽器傳送到供應商，而使用 MCP 時則由你的訂閱處理。沒有中間人，沒有按回合計費。

戰鬥與 AI

31 個工具從頭到尾管理遭遇戰：先攻、攻擊、法術、傷害、狀態、死亡豁免和經驗值。Familiar 會根據戰場快照（包含掩護分析）來處理每個 NPC 的行動，包括多重攻擊和傳奇動作。

  • 先攻、回合、輪次：整個遭遇戰流程
  • 攻擊檢定、豁免和傷害，完全自動化
  • 狀態、死亡豁免、經驗值
  • 當你需要時，根據戰場快照操控 NPC 的回合
  • 計分移動與掩護分析
  • 處理多重攻擊和傳奇動作

為所有哥布林擲先攻，讓他們攻擊最近的玩家，並播放戰鬥音樂。

NPC 語音

賦予每個 NPC 自己的聲音。跨 ElevenLabs、Cartesia 和 OpenAI 的多語音文字轉語音。Familiar 會記住誰聽起來像誰，所以旅店老闆永遠聽起來就是旅店老闆。

  • 賦予每個 NPC 自己的聲音
  • 用角色的聲音大聲說出任何台詞
  • 為整個場景配音，每個說話者都有不同聲音
  • 將固定聲音鎖定給任何角色
  • 跨三家供應商的多語音文字轉語音
  • ElevenLabs、Cartesia、OpenAI TTS

調暗燈光，開始下雨打雷，讓旅店老闆用他的聲音低聲警告前方的道路。

場景、畫布與美術

透過提問來建構整個場景：指示物、牆壁和門、燈光、天氣、戰爭迷霧、觸發區域。然後生成美術來填充它，從戰鬥地圖背景到剛走進來的陌生人的肖像。Familiar 負責放置，你負責指揮。

  • 從任何彙編中創建場景並生成指示物
  • 繪製牆壁、門和觸發區域
  • 設定燈光、黑暗和天氣效果
  • 戰爭迷霧、環境音效和攝影機控制
  • 根據文字提示生成戰鬥地圖背景
  • 在對話中生成角色肖像和物品美術

生成一張迷霧籠罩的墓園戰鬥地圖，給我三個選項，並使用第二個作為背景。

音訊與氛圍

播放、停止和管理播放清單及個別曲目，並控制音量和淡入淡出。提示戰鬥音樂、建構環境音景，或在不碰 Foundry 側邊欄的情況下讓一切靜音。

  • 播放、停止和排隊播放清單
  • 個別曲目控制，包含音量和淡入淡出
  • 在曲目之間交叉淡入淡出
  • 在戰鬥開始時提示戰鬥音樂
  • 建構環境音景
  • 在不碰側邊欄的情況下讓一切靜音

提示酒館播放清單，調暗燈光，讓吟遊詩人在底下輕柔地彈奏魯特琴曲。

知識與記憶

跨所有日誌、角色、場景和物品進行語義搜尋。一個持久的記憶庫會儲存重要的戰役事實，並在遊戲場次之間延續，同時提供完整的日誌管理功能，用於場次筆記和講義。

  • 跨日誌、角色、場景、物品進行語義搜尋
  • 跨場次的持久記憶庫
  • 當你說結束時，總結該場次內容
  • 完整的日誌和講義管理
  • 地圖圖釘的創建和編輯
  • 從任何來源發送和讀取聊天訊息

我們今晚到此為止。總結這場次發生的事情並儲存起來。

角色與物品

檢視、創建、更新和複製角色、物品欄、法術、特性和啟動效果。從彙編中匯入，套用自訂增益，並管理玩家所有權。

  • 檢視、創建、更新和複製角色
  • 管理物品欄、法術和特性
  • 套用和切換啟動效果（增益和減益）
  • 從任何彙編包匯入
  • 設定玩家所有權和權限
  • 在表格上擲骰以進行隨機遭遇和戰利品

在彙編中找到一個 CR 3 的狼人，將它作為首領放入場景，並賦予它對非銀製武器的抗性。

自動駕駛

點擊「執行 NPC」然後走開。Familiar 會為你執行每個敵人的回合，並設有安全上限和可選的逐回合確認。

  • 一鍵執行遭遇戰中所有 NPC 的回合
  • 安全上限防止失控循環
  • 需要時可進行逐回合確認
  • 與標準戰鬥追蹤器並行運作
  • 戰場快照為戰術決策提供資訊
  • 在你指定的輪次或回合停止

執行本輪所有 NPC 的回合。在龍行動完後停止。

即時轉錄

用說的代替打字。Familiar 透過三家供應商即時轉錄你的遊戲過程，按說話者進行顏色編碼，並將轉錄稿儲存到 Foundry 日誌條目中，供你稍後編輯和搜尋。

  • 在場景進行中用說的代替打字
  • 跨三家供應商的即時轉錄
  • 按說話者進行顏色編碼
  • 直接儲存到 Foundry 日誌條目
  • 事後編輯和搜尋轉錄稿
  • Gladia、Deepgram、AssemblyAI

開始轉錄這場遊戲。結束時將其儲存到名為「第 12 場」的日誌中。

多場次聊天

釘選、封存並在已命名的戰役討論串之間切換。每個討論串都會以 Foundry 日誌條目的形式持續存在，並附有完整的稽核記錄，因此你可以在之後隨時返回任何對話，即使相隔數月。

  • 釘選、封存和重新命名戰役討論串
  • 每個討論串都以 Foundry 日誌條目的形式持續存在
  • 每次工具調用的完整稽核記錄
  • 在討論串之間切換而不丟失上下文
  • 搜尋過去的對話
  • 在幾秒鐘內重新開啟暫停的支線任務

打開「暴風尖塔城堡」討論串，從我們上週中斷的地方繼續。

瀏覽橫跨 24 個領域的全部 193 個工具

協同運作

圍繞你已有的內容建構。

Familiar 不會取代你的模組、地圖或戰役。它會讀取它們、執行它們，並且不干擾你。

  • 預製戰役

開啟 Ember、Dragon of Icespire Peak 或任何已出版的冒險。Familiar 會讀取隨附的日誌條目、NPC 和遭遇戰，並在桌上執行它們，而不會憑空產生矛盾。

  • 你已經在使用的戰鬥地圖

放入一張 Czepeku 或 Patreon 地圖。Familiar 會擷取你設定的指示物、燈光、牆壁和環境音效，並在他人的創作基礎上執行戰鬥。

  • 彙編和你自己的自訂內容

你的自訂 NPC、你的房規、你從 D&D Beyond 匯入的內容。Familiar 會讀取你世界中已有的東西，而不是憑空捏造。

Familiar 不附帶自己的冒險、地圖或彙編。內容是你的。你的 AI 講述你帶來的故事，它不會自己發明一個，而 Familiar 則在此基礎上執行地下城主這一方的桌面工作。

適用於任何桌遊

單人、雙人或與一整團一起玩 D&D。

無論多少人出席，你都能玩。桌上的人類越少，Familiar 執行的世界部分就越多，規則、骰子、怪物、每個 NPC。你在你通常為其他人主持的遊戲中佔有一席之地。

  • 單人

只有你
你扮演你的角色。Familiar 執行周圍的一切：每個 NPC 都有自己的聲音，每個怪物的回合，場景，並強制執行 2024 D&D 5e 規則。戰役記憶將世界從一場次帶到下一場次。

  • 雙人

你和另一個人
你們倆都不必當 DM。Familiar 為你們倆執行世界、角色陣容、遭遇戰、裁決，所以你們保持玩家身份，故事依然推進。

  • 小型桌遊

你和幾個人
配角陣容和怪物的回合為你執行，包含燈光、音樂和裁決，所以沒有人需要跳出遊戲來讓它繼續進行。

  • 完整團隊

你為四人或以上主持 DM
戰術負擔從 GM 身上卸下。你執行遭遇戰並講述故事；Familiar 處理先攻、怪物回合和簿記工作。你經營場景，而不是試算表。

一個副駕駛，而非替代 DM。無論誰在桌上，你仍然在講述故事，而骰子和數學永遠正確。不會有「你擲出了 47」這種事。

運作方式

一則訊息輸入。Familiar 執行 Foundry 動作輸出。

無需學習新應用程式，也無需記憶指令。Familiar 從 Foundry 內部的自有聊天室運作，或從你已在使用的 MCP 客戶端運作。

  1. 你說話

在 Foundry 內的 Familiar 聊天室中輸入，或連接 MCP 客戶端，如 Claude、Codex 或 Antigravity。你的 AI 會讀取場景，並從 193 個工具中挑選要調用哪一個。 2. ### 透過安全 socket
工具調用透過已驗證的 WebSocket 到達你的世界。你的 API 金鑰直接從瀏覽器傳送到你的供應商。Familiar 絕不代理或儲存它。 3. ### Familiar 執行它
模組會執行你手動會做的相同 Foundry 操作：擲先攻、放置指示物、設定燈光、提示音樂。你保持角色扮演狀態。

內建聊天無需任何額外東西。MCP 則需要一個你用一個指令啟動的小型本地伺服器。

我為何打造這個

一個給寧願經營故事而非試算表的遊戲主持人的副駕駛。

我是 Ryan。兩個年幼孩子的父親，娶了我最愛的人，空閒時間如你所料。

我和我太太一起玩 D&D，就我們兩個人，一對一的戰役。這是我們的共同樂趣。但單人 DM 真的很累。你同時是說書人、每個 NPC、規則引擎、音效師和氣氛營造者。當我正以神秘陌生人的身份獨白到一半時，我得中斷角色去擲先攻、查法術射程、調整燈光，還得找出那個我發誓有加書籤的酒館氛圍音軌。等我回到場景時，那個時刻已經消失了。

我想要一個能處理桌面機械性事務的東西，讓我能留在故事裡。不是替代 DM，而是副駕駛。一個我可以對它說「幫哥布林擲先攻、調暗火炬、開始戰鬥音樂」的東西，它就會處理好。而我繼續說話。

所以我開始打造。一開始是幾個移動指示物和擲骰的工具。然後我加入了戰鬥追蹤。然後是場景管理。然後是「如果它也能即時生成 NPC 肖像呢？」和「如果它能為酒館老闆配音呢？」這就是你最終會得到橫跨 24 個領域和 23 個 AI 提供者的 193 個工具的原因。

我花了很多時間在這上面。我在自己的桌上運行 Familiar，一場又一場，才對外開放。我不想推出另一個 AI，在你最需要的時候忘記上週的劇情，把你的戰役搞得一團糟。

這最初是一位想為太太主持更好 D&D 遊戲的爸爸，為了解決自己的困擾而做的。結果發現很多 GM 都有同樣的困擾。

Ryan，正在開發 Familiar

定價

第一個月免費。你的金鑰，你的成本。

每月 $4 美元或每年 $36 美元，維持 Familiar 的運作。你的 AI 提供者會直接向你收取你花費的 token 費用。沒有加價、沒有中間人、沒有每回合限制。

餵養 Familiar 每月 $4 美元

運行一整年 每年 $36 美元 節省 3 個月

第一個月免費，之後每月 $4 美元。

按月或按年計費。隨時取消。

安裝到 Foundry 或開始你的免費月份

  • 所有支援的 Foundry 系統中的全部 193 個工具
  • 每次更新。戰鬥 AI、語音、圖像、轉錄、記憶
  • BYOK 或 MCP。連接清單上的任何提供者
  • 歡迎在 Discord 上提出錯誤回報和功能想法

你支付給 AI 提供者的費用

Familiar 絕不代理或加價 token。Anthropic、OpenAI、OpenRouter、你的 MCP 訂閱：你設定金鑰，他們向你收費。一場典型的 D&D 團務的 API 成本約在 $0.50 到 $3 美元之間，取決於模型。或者完全免費：透過 MCP 的訂閱或在 LM Studio 中使用本地模型，不會花費你任何 token。

常見問題

誠實回答。

玩家和 GM 真正會問的問題，直接回答。完整清單在 GitHub 上。

  • 什麼是 Familiar？

Familiar 是 Foundry VTT 的 AI 副駕駛。你透過模型上下文協議或 API 金鑰，連接你已在使用的 AI，例如 Claude 或 ChatGPT，它會運行你匯入的已出版 D&D 5e 冒險的地下城主端：規則、骰子、怪物和 NPC 語音。你繼續當玩家並主導故事；Familiar 處理桌面事務。

  • 如何將 Claude 或 ChatGPT 連接到 Foundry VTT？

有兩種方式，兩種都需要你自備 AI。使用你已付費的 Claude、ChatGPT 或 Codex 訂閱，透過模型上下文協議連接，Familiar 會作為這些客戶端連接的 MCP 伺服器運行。或者將 API 金鑰貼到內建聊天中。兩種方式都能使用相同的工具；差別在於模型在哪裡運行以及你付費給誰。
閱讀連接指南

  • Familiar 會收集我的資料嗎？

沒有遙測、沒有分析、不會回傳。Familiar 在你的 Foundry 世界中運行；只有當你向選擇的 AI 提供者發送訊息時，資料才會離開。透過 MCP 在 LM Studio 中運行本地模型，即可完全離線遊玩。

  • AI 會破壞我的世界嗎？

文件更新經過淨化處理，因此 AI 無法更改所有權、權限或內部 ID。破壞性操作需要確認，且 WebSocket 連線使用共享密鑰進行驗證。無論如何都要保留備份：無論有沒有 AI，這都是好習慣。

  • 它適用於 D&D 5e 以外的遊戲系統嗎？

完整支援僅限 D&D 5e（2024 規則）。通用功能如骰子、日誌、場景和音訊在所有地方都能運作，但系統專屬工具（角色卡、戰鬥自動化）是圍繞 dnd5e 資料模型建構的。Pathfinder 2e、Call of Cthulhu 和 Savage Worlds 已在規劃中。

  • 哪些 AI 模型效果最好？

Anthropic、OpenAI 或 Google 的任何當前旗艦模型在工具使用上表現最佳；請參閱「選擇 AI 模型」指南以了解命名層級。帶上你已付費的任何金鑰或訂閱。推理餘裕是處理艱難戰鬥或複雜場景的關鍵：內建聊天有一個思考控制項，你可以在關鍵時刻調高它，而透過 MCP，這個控制項存在於你自己的客戶端中。

  • AI 能幫我單人運行 D&D 嗎？

可以，這是它存在的主要原因之一。大多數擁有 Foundry 的人都是 GM，是那個永遠沒機會當玩家的人。Familiar 運行規則、怪物和 NPC，並跨團務記住你的戰役，讓你能在自己的桌上坐下來，單人或一對一遊玩。這就是 Familiar 的起點：和我太太的一對一 D&D。

  • 我需要有自己的戰役才能開始嗎？

不需要。購買一個 Foundry 就緒的冒險（官方 D&D 模組約 $20 到 $30 美元，地圖和燈光都已建好），放入一兩張戰鬥地圖，啟用 Familiar，你就可以開始玩了。Familiar 會讀取冒險的日誌，因此它知道你快將探索的故事，並在你進行時從你的彙編中提取怪物和物品。

  • AI 會在我這邊扮演一個角色嗎？

還不會。Familiar 運行 DM 端、規則、怪物和 NPC，所以你扮演自己的角色。讓 AI 在你旁邊運行盟友的回合已在規劃中，尚未推出。驚喜來自冒險和 Foundry 本身的戰爭迷霧，而不是來自 AI 保守秘密。AI 無法隱藏它能讀取的東西。

  • AI 能作為地下城主運行我的遊戲嗎？

可以，但有一個誠實的附帶條件。AI 不善於創造故事，所以 Familiar 不要求它們這樣做。你帶入一個已出版的冒險及其地圖和 NPC，你的 AI 讀取並運行它，而人類可以隨時接管。連接你自己的 AI，它就能運行整個 DM 端，並跨團務記住你的戰役。

開發路線圖

我正在努力的方向。

不對時間表做出承諾。大致按優先順序排列。

更好的單人和雙人遊戲。

獻給那位為其他人主持遊戲，並想偶爾當一次玩家的 GM。Familiar 已經能運行 DM 端；這些功能將為一或兩人的桌子進行優化。

  • 同伴隊伍填充：讓 AI 運行指定盟友的戰鬥回合
  • 遭遇戰規模調整：為單人或雙人隊伍平衡戰鬥
  • 單人模式：一鍵預設規則、怪物和 NPC 語音

與你已在使用的模組對話。

讓 Familiar 驅動你 Foundry 堆疊的其餘部分：自動化擲骰、動畫、戰利品、效果。

  • Midi-QOL：自動化攻擊擲骰和豁免
  • Sequencer + JB2A：編排法術動畫
  • Token Magic FX：指示物和圖塊上的著色器效果
  • Item Piles：戰利品掉落和商人
  • DFreds Convenient Effects：狀態效果和增益

更多系統，超越 D&D 5e。

完整的系統專屬工具：角色卡、戰鬥自動化、法術解析。

  • D&D 5e (2024) 已推出
  • Pathfinder 2e 規劃中
  • Call of Cthulhu 規劃中
  • Savage Worlds 規劃中

隨插即玩的戰役。

匯入已出版的冒險，Familiar 就能立刻知道故事、NPC、地圖和遭遇戰。從 Ember 開始。

Ember 是 Foundry 官方 500 小時沙盒戰役。更多已出版冒險將陸續推出。

強化已推出的功能。

  • 戰鬥 AI：撤退、士氣、團隊協調
  • 語音：情緒控制、更自然的多角色語音場景
  • 圖像：跨團務保持一致的角色肖像
  • MCP：為外部客戶端提供更豐富的即時工具進度回饋

有想法嗎？Discord 是推動某項功能排上清單的最佳場所。

準備好當一次玩家了嗎？

在 Foundry 中安裝 Familiar，你的第一個月免費。隨時取消，你的世界永遠屬於你。

我是 Ryan，我打造了 Familiar。加入 Discord，我會親自幫助你開始。