🚀 两真一转折：全球首款模型上下文协议（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是一个益智游戏，规则如下：
- AI创建一个主题回合，包含三个关于同一话题的陈述——两个事实和一个“转折”（一个有趣且错误的陈述）
- 玩家尝试识别哪个陈述是转折
- AI揭示答案并提供有趣的解释
开发者指南
此包实现了一个提供自定义游戏工具的MCP服务器，包含以下接口：
create_round：创建一个新的游戏回合，包含一个问题和三个陈述submit_guess：允许玩家提交他们对哪个陈述是转折的猜测reveal_twist：揭示答案并为每个陈述提供解释get_round：获取特定回合的详细信息get_last_round：获取最近一个回合的详细信息get_stats：获取游戏统计数据