fannnnnnn5822/tavern-tanuki

酒馆小狸 — MCP server that lets coding agents manage AND play a running SillyTavern: characters, worldbooks, chats, presets

About tavern-tanuki

把你的 AI 编程助手（Claude Code / Cursor / Codex…）变成酒馆跑堂：直接读写正在运行的酒馆（角色卡、世界书、聊天记录），还能替你玩卡/陪你玩卡（代发消息、触发回复、切预设、切模型）。

An MCP server that lets coding agents manage and play a running SillyTavern instance.

部件 装在哪 作用 --------- MCP 服务器（本仓库） AI 编程助手侧（如 Claude Code 的 .mcp.json） 读写卡/世界书/聊天，全走酒馆 HTTP API 小狸连接器（tavern-script/酒馆小狸连接器.json，可选） 酒馆侧：酒馆助手 → 脚本库 → 导入此 JSON 文件 陪玩功能：代发消息/触发生成/切预设切模型

管理组：ststatus listcharacters getcharacter editcharacter（自动同步顶层+data. 两份副本）mergecharacterdata listworldbooks getworldbook（summary 模式省 token）upsertworldbookentry deleteworldbookentry deleteworldbook（需 confirm）listchats getchat

陪玩组：playstatus playsend（以用户身份发消息并等回复，完整走预设/世界书/正则管线）playtrigger playrecentmessages playgetprompt（⭐提示词 X 光机：捕获每次真正发给 LLM 的完整组装提示词——含用户手动生成的——验证世界书激活/插入顺序/标签结构；summary 模式省 token，search 定位条目，index 取单条全文）playlistpresets playsetpreset playsetmodel playstscript（STScript 万能后门）

要求：Node ≥ 18，本地运行的 SillyTavern（默认 http://127.0.0.1:8000）。

1. clone 本仓库，npm install 2. 在 AI 编程助手的 MCP 配置里加：

3. （可选，陪玩用）在酒馆助手 → 脚本库 → 导入，选择 tavern-script/酒馆小狸连接器.json。连接成功酒馆会弹「已连接 AI 编程助手」。

导入的是一个轻量加载器：真正的连接器本体托管在本仓库 dist/connector.js，由 jsDelivr 分发、Supabase 版本指针控制——导入一次，之后每次更新自动生效，不用重新导入。想审代码就看 dist/connector.js（这就是实际在你酒馆里运行的全部代码）。

环境变量：STBRIDGEPORT 可改陪玩桥端口（默认 6700，只监听 127.0.0.1）。

酒馆的提示词组装（预设/世界书/正则）都发生在浏览器侧，纯服务器 API 触发不了完整生成。所以连接器脚本在酒馆里开一条 WebSocket 连到本机 MCP 服务器，agent 的 playsend → 浏览器里 createChatMessages + /trigger → 等 GENERATIONENDED → 把回复带回来。生成走的是你正常游玩的完整管线。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/fannnnnnn5822--tavern-tanuki.html)

Related MCP servers