MCP 服务器

HUMMBL MCP Server

Provides access to the HUMMBL Base120 framework of 120 validated mental models organized across 6 transformations, enabling users to search, retrieve, and get AI-recommended mental models for problem-solving and decision-making.

README

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"]
    }
  }
}

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

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