mcp

This MCP server provides access to HUMMBL Base120 mental models through a set of tooling commands. It exposes a catalog of 120 mental models organized by transformations (such as Perspective, Inversion, Composition, Decomposition, Recursion, and Meta-Systems) and offers utilities to fetch model details, list models by transformation, search by keywords, and generate AI-assisted recommendations for complex problems. Available tools include get_model (retrieve details for a single model), list_all_models (enumerate models and optionally filter by transformation), search_models (find models by keyword), recommend_models (get model suggestions based on a problem description), get_transformation (retrieve information about a transformation and its models), and search_problem_patterns (locate predefined problem patterns and suggested approaches). These tools enable structured problem analysis and guided application of HUMMBL mental models to real-world scenarios.

Prerequisites:

• Node.js and npm (Node 14+ recommended)
• Basic terminal usage

Install options:

1. Global installation (recommended for frequent use):

npm install -g @hummbl/mcp-server

2. Run directly with npx (no prior installation required):

npx @hummbl/mcp-server

3. Local installation (per-project):

mkdir my-mcp-project
cd my-mcp-project
npm init -y
npm install @hummbl/mcp-server
# Run using npx or a script in package.json
npx @hummbl/mcp-server

Configuration references (optional): you can wire up your Claude Desktop or other clients to point to the MCP server using the npx invocation shown above.

Tips and common considerations:

• If you use the Claude Desktop integration, you can configure the mcpServers entry to use npx with the package name as shown in the README example.
• The server exposes standard tools for model lookup and discovery; you can chain tool usage to explore models before applying them to a problem.
• Ensure your environment has network access to fetch the MCP server package when using npx.
• For local development, you can pin a specific version of @hummbl/mcp-server in package.json to ensure reproducible results.
• If you encounter loading or network errors, verify Node.js/npm versions and npm registry connectivity. Clearing npm cache or using a clean environment often helps during setup.