Haiguitangmcp

What is Haiguitangmcp?

Haiguitangmcp is an MCP server that enables large language models to act as hosts of the "Haiguitang" (turtle soup) game—a situational reasoning puzzle game. It is designed for individuals who want to enjoy the game alone, with the LLM providing puzzles, answering yes/no questions, and guiding the player toward the solution.

How to use Haiguitangmcp?

You need Python and uv installed. Clone the repository, run uv sync to install dependencies, then configure the server in your MCP client (e.g., VSCode or Cherry Studio) by setting the command to uv with arguments pointing to server.py. The server exposes three tools, a resource URI, and a prompt template for game rule instructions.

Key features of Haiguitangmcp

• Three tools: get_prompt, get_puzzle, list_puzzles_tool
• Resource URI puzzles://{puzzle_title} to retrieve puzzle details
• Prompt template game_rules for game rule instructions
• Ships with 35 pre‑loaded puzzles
• Supports puzzle contribution via pull requests

Use cases of Haiguitangmcp

• Play the turtle soup reasoning game solo with an AI host
• Retrieve puzzle lists and individual puzzle content programmatically
• Obtain game rules and hints to assist in puzzle solving
• Integrate the game into larger chatbot or assistant workflows

FAQ from Haiguitangmcp

What are the rules of the turtle soup game?

The host provides a puzzling scenario. The player asks questions that the host answers with "yes", "no", "yes and no", or "irrelevant". The player can attempt to describe the full story by starting a message with "汤底" (the solution). The host may offer hints and confirms when the solution is correct.

How many puzzles are available?

The server currently includes 35 puzzles. Ten recommended ones are listed, such as "忠诚的狗" (Loyal Dog) and "100元钱" (100 Yuan).

How can I add a new puzzle?

Place a new puzzle file in the haiguitang_mcp/puzzles folder and submit a pull request. Note any content warnings in the file title and respect copyright.

What dependencies are required?

Python and uv must be installed. After cloning the repo, run uv sync to install project dependencies.

Does the server require internet access?

No. The server runs locally via stdio transport. All puzzles are stored in local files; no external API or network connection is needed.