Two Truths and a Twist

🚀 两真一转折：全球首款模型上下文协议（MCP）游戏

两真一转折是全球首款基于模型上下文协议（MCP）的游戏，借助MCP协议为玩家带来有趣且互动性强的知识问答体验，由AI生成内容并执行游戏流程。

游戏设计文档

🚀 快速开始

你可以按照以下步骤快速开启两真一转折游戏之旅，体验其独特魅力。

📦 安装指南

通过Smithery安装

要通过Smithery自动为Claude桌面安装twotruthsandatwist，可使用以下命令：

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

查看游戏统计信息

若要查看游戏统计数据，可使用以下命令：

ttaat db stats

连接到服务器

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

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

对于Claude桌面版，请将此文件放置在相应位置：

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

高级用法

开始游戏

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

让我们一起玩两真一转折！创建一个关于太空探索的主题回合。

创建一个关于古代文明的游戏回合。

📚 详细文档

游戏机制

Two Truths and a Twist是一个益智游戏，规则如下：

1. AI创建一个主题回合，包含三个关于同一话题的陈述——两个事实和一个“转折”（一个有趣且错误的陈述）
2. 玩家尝试识别哪个陈述是转折
3. AI揭示答案并提供有趣的解释

开发者指南

此包实现了一个提供自定义游戏工具的MCP服务器，包含以下接口：

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