hummbl-dev/mcp-server

HUMMBL MCP Server

Model Context Protocol server providing access to the HUMMBL Base120 mental models framework.

Overview

HUMMBL Base120 is a comprehensive cognitive framework consisting of 120 validated mental models organized across 6 transformations:

• P (Perspective): Change viewpoint to see problems differently
• IN (Inversion): Flip problem to find solution by avoiding failure
• CO (Composition): Combine elements to create emergent properties
• DE (Decomposition): Break down complexity into manageable components
• RE (Recursion): Apply patterns at multiple scales and iterations
• SY (Meta-Systems): Understand rules, patterns, and systems governing systems

Installation

Global Installation (Recommended)

npm install -g @hummbl/mcp-server

Using npx (No Installation Required)

npx @hummbl/mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hummbl": {
      "command": "npx",
      "args": ["-y", "@hummbl/mcp-server"]
    }
  }
}

get_methodology

Retrieve the canonical Self-Dialectical AI Systems methodology, including all stages and HUMMBL Base120 references.

Example:

{}

audit_model_references

Audit a list of HUMMBL model references for validity, duplication, and transformation alignment.

Example:

{
  "items": [
    { "code": "IN11", "expectedTransformation": "IN" },
    { "code": "CO4" }
  ]
}

After configuration, restart Claude Desktop. The HUMMBL tools will appear in the attachment menu.

Available Tools

get_model

Retrieve detailed information about a specific mental model.

Example:

{
  "code": "P1"
}

list_all_models

List all 120 mental models, optionally filtered by transformation type.

Example:

{
  "transformation_filter": "P"
}

search_models

Search models by keyword across names, descriptions, and examples.

Example:

{
  "query": "decision"
}

recommend_models

Get AI-recommended models based on problem description.

Example:

{
  "problem_description": "Our startup is growing rapidly but systems are breaking down. We need to scale operations without losing quality."
}

get_transformation

Retrieve information about a specific transformation type and all its models.

Example:

{
  "type": "IN"
}

search_problem_patterns

Find pre-defined problem patterns with recommended approaches.

Example:

{
  "query": "innovation"
}

Available Resources

Direct URI-based access to models and transformations:

• hummbl://model/{code} – Individual model (e.g., hummbl://model/P1)
• hummbl://transformation/{type} – All models in transformation (e.g., hummbl://transformation/P)
• hummbl://models – Complete Base120 framework
• hummbl://methodology/self-dialectical-ai – Structured Self-Dialectical AI methodology definition
• hummbl://methodology/self-dialectical-ai/overview – Markdown overview of the methodology for quick operator reference

Self-Dialectical Methodology Overview

The HUMMBL Self-Dialectical AI Systems methodology (v1.2) enables ethical self-correction via five dialectical stages (thesis, antithesis, synthesis, convergence, meta-reflection) mapped to Base120 mental models plus SY meta-models. Use the tools/resources above to fetch the canonical JSON definition, Markdown overview, or to audit references in external documents.

Development

Setup

git clone https://github.com/hummbl-dev/mcp-server.git
cd mcp-server
npm install

Build

npm run build

Run Locally

npm run dev

Type Checking

npm run typecheck

Architecture

src/
├── index.ts              # stdio entry point
├── server.ts             # Server configuration
├── framework/
│   └── base120.ts        # Complete mental models database
├── tools/
│   └── models.ts         # Tool registrations
├── resources/
│   └── models.ts         # Resource endpoints
├── types/
│   └── domain.ts         # Core type definitions
└── utils/
    └── result.ts         # Result pattern utilities

License

MIT © HUMMBL, LLC

Version

1.0.0-beta.1