wangyafu

Introduction

This project aims to enable large language models to act as the host for the Turtle Soup game, allowing you to enjoy the fun of the Turtle Soup game even when you are alone.

Quick Start

Before using this project, make sure that Python and uv are installed on your computer.

You first need to clone the entire project and then run uv sync to install dependencies. bash git clone https://github.com/wangyafu/haiguitangmcp cd haiguitangmcp uv sync

Next, you need to modify the configuration file (assuming you have installed the project on the E drive).

Configuration in VSCode

json "mcp": { "servers": { "haiguitang-mcp": { "type": "stdio", "command": "uv", "args": [ "--directory", "E:\haiguitangmcp\haiguitang_mcp", "run", "server.py" ] } } }

Configuration in Cherry Studio

json "mcpServers": {

"haiguitang": {
  "isActive": true,
  "name": "海龟汤MCP服务器",
  "description": "和用户玩海龟汤",
  "registryUrl": "",
  "command": "uv",
  "args": [
    "--directory",
    "E:/haiguitangmcp/haiguitang_mcp",
    "run",
    "server.py"
  ]
},

}

The path "E:/haiguitangmcp/haiguitang_mcp" indicates where server.py is located.

The configuration method in other MCP clients is similar.

MCP Related Content

This project provides three tools:

• get_prompt: Get the complete instructions for the Turtle Soup game.
• get_puzzle: Get the full content of a specific puzzle, requiring the puzzle title as a parameter.
• list_puzzles_tool: List all available puzzles.

Additionally, this project offers the following resources:

• puzzles://{puzzle_title}: Get information about a specific puzzle.

And a prompt template:

• game_rules: A prompt template providing the rules of the Turtle Soup game.

Game Rules

In this game:

• Turtle Soup is a situational reasoning game. The puzzle itself does not have strong logic but focuses on whether one can discover key clues to recreate the scenario.
• The puzzle setter presents an apparently illogical question and situation (the puzzle surface). The guesser narrows down the scope through questions and ultimately reveals the complete story (the solution).
• The guesser can ask any question, and the puzzle setter mainly responds with "yes," "no," "yes and no," or "irrelevant."
• When a question contains both correct and incorrect elements, the puzzle setter will respond with "yes and no."
• When a question is unrelated to the core plot of the puzzle, the puzzle setter will respond with "irrelevant."
• The guesser can try to describe the complete scenario by adding "soup base" at the beginning of the message.
• When the guesser has grasped the key clues, the puzzle setter will remind the guesser to summarize the clues and form a complete description of the solution.
• The guesser can request guidance and hints, and the puzzle setter will provide clues that have not yet been mastered.
• When the guesser's description roughly includes the key scenarios of the puzzle, the puzzle setter will confirm "completely correct."

Tips

• Start with basic questions, such as the number of people involved in the puzzle or the cause of death.
• Pay attention to every detail in the puzzle surface; they may be key clues.
• When you feel confused, try thinking about the problem from different angles.
• Record confirmed clues to help organize and summarize them.

About the Puzzles

Currently, this project provides 35 puzzles.I once developed the Turtle Soup Simulator, a website that includes a rating feature. The current 35 puzzles on the site have been collected by me and some enthusiastic users. Based on the ratings of these puzzles on the website, the following are recommended for play:

• Loyal Dog
• 100 Yuan
• Beloved Dog
• Healing
• Memorial Day
• People in the Elevator
• Delayed Death
• Business
• Torn Pants
• Close Friends

You are welcome to contribute more puzzles to this project. You can add new puzzle files to the haiguitang_mcp/puzzles folder and then initiate a Pull Request.

Note:

• If you want to give users a warning before they start playing, you can include it in the title, which is also the name of the puzzle file.
• Please be mindful of the copyright issues related to Turtle Soup.
• You may add author and contributor information within the Turtle Soup files.

来源

• 来源：github
• 链接：https://github.com/wangyafu/haiguitangmcp