Twine Mcp

БесплатноНе проверен

MCP server for Twine interactive story authoring

автор: ej-sanmartin

GitHub Embed

Описание

MCP server for Twine interactive story authoring

README

Twine MCP

MCP server for AI-assisted Twine interactive story authoring. Edits .twee files directly, provides build tooling to output playable HTML, and can export stories for visualization in the Twine GUI.

Works with Cursor, Claude Code, Claude Desktop, and Codex CLI.

Setup

npm install -g @unveil-gg/twine-mcp
twine-mcp setup

The wizard asks for your workspace directory, picks your editor, and writes the MCP config — no manual JSON editing.

Restart your editor when done. Ask your AI to run ping to confirm.

Manual config

Add to your editor's MCP config (~/.cursor/mcp.json, ~/.claude.json, etc.):

{
  "mcpServers": {
    "twine": {
      "command": "twine-mcp",
      "env": {
        "TWINE_PROJECT": "/Users/yourname/Documents/games"
      }
    }
  }
}

TWINE_PROJECT can point to a single game folder or a workspace containing multiple games. The server discovers all projects automatically, and supports multiple workspace roots at once — including the folder open in your editor. See DEVELOPMENT.md for details.

Tools

Category	Tools
Stories	`list_stories`, `get_story`, `create_story`, `delete_story`, `export_twee`
Passages	`list_passages`, `get_passage`, `create_passage`, `update_passage`, `delete_passage`, `rename_passage`, `set_start_passage`, `batch_update`
CSS	`get_stylesheet`, `update_stylesheet`
Graph	`get_link_graph`, `find_broken_links`, `find_dead_ends`, `find_orphans`, `find_cycles`, `get_passage_path`, `get_reachable_passages`
Analysis	`analyze_story`, `get_story_stats`, `search_passages`, `find_variable_usage`, `check_tag_consistency`
Narrative	`summarize_story`, `get_story_context`, `get_narrative_flow`, `get_all_endings`, `get_passage_context`, `get_story_branches`
Project	`create_project`, `build_story`, `validate_story`, `import_from_twine`, `export_for_twine`, `move_passage`, `list_files`
Formats	`list_story_formats`, `get_format_info`, `get_format_syntax_guide`
Refactor	`split_passage`, `merge_passages`
Utility	`ping`, `get_config`, `list_workspace_roots`, `rescan_workspace`

MCP Resources: twine://stories, twine://story/{name}, twine://story/{name}/graph, twine://story/{name}/summary

Recommended AI workflow

ping → summarize_story → get_story_context → get_story_branches
     → get_narrative_flow → get_passage_context → get_all_endings

Start cheap (summarize_story ≈ 200 tokens), go deeper only when needed.

Contributing & development

CONTRIBUTORS.md — local setup, how to help, AI usage policy
DEVELOPMENT.md — release workflow, npm auth, CI

from github.com/Unveil-gg/twine-mcp

Установить Twine Mcp в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install twine-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add twine-mcp -- npx -y @unveil-gg/twine-mcp

FAQ

Twine Mcp MCP бесплатный?

Да, Twine Mcp MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Twine Mcp?

Нет, Twine Mcp работает без API-ключей и переменных окружения.

Twine Mcp — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Twine Mcp в Claude Desktop, Claude Code или Cursor?

Открой Twine Mcp на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare Twine Mcp with

Twine McpvsFetch Twine McpvsAWS KB Retrieval Twine McpvsSpring AI MCP Server Twine Mcpvsllm-analysis-assistant

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai

Command Palette