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：獲取遊戲統計數據