TwoTruthsAndATwist

两个真相和一个转折：世界上第一个基于模型上下文协议（MCP）的游戏

游戏设计文档

安装

通过 Smithery 安装

要通过 Smithery 自动安装 twotruthsandatwist 到 Claude Desktop：

npx -y @smithery/cli install @ErgodicLabs/twotruthsandatwist --client claude

系统要求

• Python 3.13 或更高版本
• 兼容 MCP 的大语言模型（如 Claude 3）

你可以直接从 PyPI 安装该游戏：

pip install ttaat

或者如果你更喜欢使用 uv：

uv pip install ttaat

使用方法

初始化数据库

首先，初始化游戏数据库：

ttaat db upgrade

启动游戏服务器

要启动 MCP 服务器：

ttaat serve

这将启动 Two Truths and a Twist MCP 服务器，大语言模型可以连接到此服务器来玩游戏。

查看游戏统计数据

要查看游戏统计数据：

ttaat db stats

连接到服务器

要将兼容 MCP 的大语言模型连接到游戏服务器，你需要配置 MCP 连接。创建一个配置文件（例如 claude_desktop_config.json），内容如下：

{
  "mcpServers": {
    "TwoTruthsAndATwist": {
      "command": "ttaat",
      "args": ["serve"]
    }
  }
}

对于 Claude Desktop，将此文件放置在以下位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

游戏机制

Two Truths and a Twist 是一款猜谜游戏，其中：

1. AI 创建一轮关于某个主题的三个陈述——两个真相和一个“转折”（一个有趣的虚假陈述）
2. 玩家尝试找出哪个陈述是转折
3. AI 揭示答案并提供有趣的解释

该游戏利用 MCP 协议提供了一个有趣且互动的猜谜体验，AI 模型不仅生成内容，还促进游戏玩法。

示例提示

一旦连接到启用 MCP 的大语言模型，你可以用以下提示开始游戏：

让我们玩 Two Truths and a Twist！创建一轮关于太空探索的内容。

创建一轮关于古代文明的游戏。

开发者指南

此包实现了一个 MCP 服务器，提供了自定义游戏工具：

• create_round: 创建一个新的游戏轮次，包含一个问题和三个陈述
• submit_guess: 让玩家提交他们对哪个陈述是转折的猜测
• reveal_twist: 揭示答案，并为每个陈述提供解释
• get_round: 获取特定轮次的详细信息
• get_last_round: 获取最近一轮的详细信息
• get_stats: 获取游戏统计数据