使用说明

项目简介

Two Truths and a Twist MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，用于支持 "Two Truths and a Twist" trivia 游戏。该服务器允许 LLM 客户端通过 MCP 协议进行连接，体验互动式的游戏玩法。游戏中，AI 创建包含两个真相和一个 "twist" (有趣的假陈述) 的回合，玩家需要识别哪个是 twist。

主要功能点

• 创建游戏回合 (create_round): AI 可以调用此工具创建新的游戏回合，指定主题、问题和三个陈述（两个真相和一个 twist）。
• 提交猜测 (submit_guess): 玩家可以提交对哪个陈述是 twist 的猜测。
• 揭示真相 (reveal_twist): AI 可以揭示哪个陈述是 twist，并为所有陈述提供有趣的解释。
• 获取回合信息 (get_round, get_last_round): 获取指定或最近一回合的详细信息。
• 获取游戏统计 (get_stats): 查看游戏的总回合数、玩家得分、AI 得分以及 twist 分布统计。

安装步骤

1. 环境要求: Python 3.13 或更高版本。
2. 安装软件包: 使用 pip 或 uv 安装 'ttaat' 包：

   pip install ttaat
   

   或

   uv pip install ttaat
   

3. 初始化数据库: 运行以下命令初始化游戏数据库：

   ttaat db upgrade
   

服务器配置

要将 MCP 兼容的 LLM 客户端（如 Claude Desktop）连接到此服务器，请创建一个配置文件（例如 'claude_desktop_config.json'），并填入以下内容。请根据您的客户端要求放置此配置文件。

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

• 'mcpServers': 定义 MCP 服务器的配置。
  • 'TwoTruthsAndATwist': 服务器名称，可以自定义。
    • 'command': 启动 MCP 服务器的命令，这里是 'ttaat'，即安装后可用的命令行工具。
    • 'args': 传递给启动命令的参数，这里 '["serve"]' 指示 'ttaat' 命令行工具运行服务器模式。

基本使用方法

1. 启动服务器: 运行以下命令启动 MCP 服务器：

   ttaat serve
   

2. 连接 LLM 客户端: 配置您的 MCP 客户端连接到名为 "TwoTruthsAndATwist" 的服务器。
3. 开始游戏: 在 LLM 客户端中使用自然语言提示与服务器交互，例如：

   Let's play Two Truths and a Twist! Create a round about space exploration.
   

   或

   Create a game round about ancient civilizations.