Frequently Asked Questions about the Haiguitang MCP Server

Q: What is Haiguitang? A: Haiguitang, also known as lateral thinking puzzle, is a type of puzzle where you need to figure out a hidden situation by asking questions. The puzzle gives you a strange or impossible scenario, and you have to uncover the story behind it.

Q: How does the Haiguitang MCP server work? A: The server uses a Large Language Model (LLM) to act as the game master. You ask questions, and the LLM responds based on the puzzle’s story, helping you to uncover the full scenario.

Q: What do ‘yes’, ‘no’, ‘irrelevant’, and ‘yes and no’ answers mean? A: These are the only allowed answers to your questions. ‘Yes’ means your question is correct and helps reveal the story. ‘No’ means your question is incorrect. ‘Irrelevant’ means your question doesn’t relate to the puzzle’s core. ‘Yes and no’ means part of your question is correct and part is not.

Q: What are the available tools in this project? A: This project provides three tools: get_prompt (to get the rules), get_puzzle (to get a specific puzzle), and list_puzzles_tool (to list available puzzles).

Q: How do I install the Haiguitang MCP server? A: You need to have Python and uv installed. Clone the repository, install dependencies with uv sync, and then configure the server in your MCP client (like VS Code or Cherry Studio).

Q: Can I add my own puzzles to the server? A: Yes, you can. Add your puzzle files to the haiguitang_mcp/puzzles directory and submit a pull request.

Q: What is MCP (Model Context Protocol)? A: MCP is an open protocol that standardizes how applications provide context to LLMs. It allows AI models to access and interact with external data sources and tools.

Q: How does this server integrate with UBOS? A: UBOS allows you to orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems, enhancing the puzzle-solving experience.

Q: Where can I find recommended puzzles to play? A: The project includes a list of recommended puzzles based on user ratings from a dedicated Haiguitang simulator website. Look for puzzles like ‘Loyal Dog,’ ‘100 Yuan,’ ‘Pet,’ ‘Cure,’ ‘Anniversary,’ and more.

Q: What if I get stuck on a puzzle? A: Try starting with basic questions about the puzzle’s elements, like the number of people involved or the cause of any deaths. Pay attention to details in the puzzle description, and try thinking from different angles.

Q: What should I be aware of when contributing puzzles? A: Please be mindful of Haiguitang’s copyright issues and include author and contributor information in your puzzle files. If the puzzle contains sensitive content include a warning in the file name.