Frequently Asked Questions (FAQ)

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. It’s a standardized protocol that allows applications to provide context to Large Language Models (LLMs), enabling them to access and interact with external data sources and tools.

Q: What is BoardGameGeek (BGG)? A: BoardGameGeek is a comprehensive online resource for board game enthusiasts, containing information on thousands of games, including descriptions, ratings, reviews, and user collections.

Q: What does this MCP Server do? A: This MCP server connects the Claude AI assistant to the BoardGameGeek XML API, allowing Claude to search for board games, retrieve game details, manage user collections, and more.

Q: What are the prerequisites for running the MCP Server? A: You need Node.js 22.5.0 or higher (for experimental SQLite support) and npm (for dependency management).

Q: How do I install the MCP Server? A: First, install the dependencies using npm install. Then, build the TypeScript code using npm run build.

Q: How do I run the MCP Server? A: You can run the server directly using node --experimental-sqlite build/index.js or using Docker.

Q: How do I connect the MCP Server to Claude for Desktop? A: You need to configure the claude_desktop_config.json file by adding the server configuration for either direct Node.js execution or Docker.

Q: Why is Docker recommended? A: Docker provides a more isolated and reproducible environment, ensuring consistent performance and preventing conflicts with other software on your system.

Q: What is the purpose of the -v "$(pwd)/data:/app/data" option in the Docker configuration? A: This option mounts the local data directory to the /app/data directory in the Docker container, ensuring that the SQLite database is persisted outside the container and preventing data loss between server restarts.

Q: What kind of questions can I ask Claude once the MCP Server is connected? A: You can ask questions like “What are the new hot games on boardgamegeek?” or “Look up the game Molly House on boardgamegeek.”

Q: Where is the data stored? A: The server uses SQLite for data persistence. All retrieved game data, user collections, and play history are stored in the data/bgg.sqlite database file.

Q: What are the benefits of using SQLite for data storage? A: SQLite reduces API calls to BoardGameGeek, improves response times for repeated queries, and maintains data between server restarts.

Q: Can I use this MCP server with other AI models besides Claude? A: While this MCP server is specifically configured for Claude, the general principles and code can be adapted for use with other AI models that support the MCP protocol.

Q: Is this MCP server part of the UBOS platform? A: Yes, this MCP server is available on the UBOS Asset Marketplace and is designed to integrate seamlessly with the UBOS AI Agent Development Platform.

Q: What is UBOS? A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. It helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems.