Haiguitangmcp

Name: Haiguitangmcp
Author: wangyafu

@wangyafu

Repository

About Haiguitangmcp

No overview available yet

#mathgpt #math-solver #math-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "haiguitangmcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.