Haiguitangmcp

🚀 HaiguiTang Game Hosted by Large Language Model

This project enables large language models to act as the host of the HaiguiTang (Lateral Thinking Puzzle) game, allowing you to enjoy the game even when you're alone.

🚀 Quick Start

Before using this project, you need to ensure that Python and uv are installed on your computer.

First, you need to clone the entire project and then run uv sync to install the dependencies.

git clone https://github.com/wangyafu/haiguitangmcp/
cd haiguitangmcp
uv sync

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

Configuration in VSCode

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

Configuration in Cherry Studio

"mcpServers": {
    
    "haiguitang": {
      "isActive": true,
      "name": "HaiguiTang MCP Server",
      "description": "Play HaiguiTang with users",
      "registryUrl": "",
      "command": "uv",
      "args": [
        "--directory",
        "E:\\haiguitangmcp\\haiguitang_mcp",
        "run",
        "server.py"
      ]
    }
}

📚 Documentation

Tools and Resources

• Tools:

  • get_prompt: Get the game rules.
  • get_puzzle: Get the specific content of a puzzle based on its title.
  • list_puzzles_tool: List all available puzzles.

• Resources:

  • Provide puzzle content and hint templates, especially the game_rules template for the host's answering rules.

Game Rules

• The guesser gets clues by asking questions.
• The question setter answers questions according to the rules:
  • "Yes": When the answer is correct and some clues are available.
  • "No": When the answer is not entirely correct but some clues are available.
  • "Yes and no": When the answer is incorrect but some clues are available.
  • "Irrelevant": When the answer is incorrect and no clues are available.

Tips

• Start with basic questions, pay attention to details, think from multiple perspectives, and record the confirmed clues to enhance the gaming experience.

Puzzle Expansion

The project provides 35 puzzles. You're welcome to contribute more puzzles. Simply add text files in the specified folder and submit a Pull Request.

⚠️ Important Note

• Indicate warning information in the title.
• Handle copyright issues and avoid using protected content.
• Add author information.

By gradually configuring the environment and code, you'll be able to implement an interesting and interactive HaiguiTang game host. Although you may encounter some problems, they can be solved through debugging and referring to relevant materials.