Two Truths And A Twist

🚀 两真一转折：全球首款模型上下文协议（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

これにより、Two Truths and a Twist MCPサーバーが起動し、大規模言語モデルが接続してゲームに参加できるようになります。

ゲーム統計情報の表示

ゲームの統計データを表示するには、以下のコマンドを実行します。

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

📚 ドキュメント

ゲームの仕組み

Two Truths and a Twistは、以下のルールに従う知識クイズゲームです。

1. AIが、同一のトピックに関する3つの陳述を含むテーマラウンドを作成します。このうち2つは事実で、1つは「トワイスト」（面白くて誤った陳述）です。
2. プレイヤーは、どの陳述がトワイストであるかを識別しようとします。
3. AIが答えを明かし、面白い説明を提供します。

このゲームは、MCPプロトコルを利用して、ユーザーに面白くてインタラクティブな知識クイズ体験を提供します。AIモデルは内容を生成するだけでなく、ゲームの進行も担当します。

サンプルプロンプト

MCPをサポートする大規模言語モデルに接続したら、以下のプロンプトでゲームを開始できます。

一緒に两真一转折を遊びましょう！宇宙探査に関するテーマラウンドを作成してください。

古代文明に関するゲームラウンドを作成してください。

🔧 技術詳細

このパッケージは、カスタムゲームツールを提供するMCPサーバーを実装しています。

• create_round：新しいゲームラウンドを作成し、問題と3つの陳述を含みます。
• submit_guess：プレイヤーがどの陳述がトワイストであるかの推測を送信できます。
• reveal_twist：答えを明かし、各陳述の説明を提供します。
• get_round：特定のラウンドの詳細情報を取得します。
• get_last_round：最近のラウンドの詳細情報を取得します。
• get_stats：ゲームの統計データを取得します。