Meaning Model MCP server

The Meaning Model

Construct worlds coarsely, then develop the parts that matter. The Meaning Model connects world records, concepts, descriptions, understanding, and story text in one addressed representation. Finer detail must respect an accepted account or revise it explicitly.

This repository brings together the theory, its compact grammar appendix, the Rust engine and MCP interface, and The Book of Conditions, a worked construction with a complete twelve-chapter manuscript.

See the changelog for release changes, upgrade notes, and unreleased work.

Choose the model your application needs

Model only what serves your purpose. Choose the processes, categories, relationships, and level of detail; use a supplied template, adapt its output, or author a model directly. A single process is a valid starting point. A browser, learning tool, or relationship application need not build the same account of a person, or a complete person model at all.

The intended use is an external model an AI can work with: connect observations across time, compare explanations, explore possible developments, and decide what to investigate next. The modeler supplies those interpretations; the tool preserves their structure and revisions and executes supported, declared laws. Categories and decompositions are part of what the modeler develops and tests, not a fixed inventory to fill in. Shared record and validation rules remain in force as the application vocabulary changes.

See application-specific categories for template choices and a runnable vocabulary-revision example.

Read first

The paper and grammar appendix were revised on September 12, 2026. The Zenodo series provides the archived versions.

construction method, examples, and numerical portrait.

• Meaning Model paper - the argument, grammar,

to the same rules, not a separate theory or additional set of requirements.

• Grammar appendix - a focused reference

are also included.

• The Book of Conditions
• the completed story; Markdown and model sources

The six world-record forms are Concept, Thing, Event, Binding, Cut, and Realization. A Cut divides one declared unit among exclusive sibling answers and an explicit remainder; its weights sum to one. Ordinary process links are unweighted. Dates, money, counts, and physical measurements keep their external units. Understanding Nodes and Document Nodes share the address space without acquiring the authority of accepted world facts.

Try it

The smallest demonstration requires only Node.js:

node --test examples/refinement-trial/example.test.mjs

It shows a refinement that fits its parent, a locally valid refinement that contradicts the parent, and an explicit revision. The example is synthetic, not evidence that the full implementation or learning proposal is complete.

For the Rust engine and MCP tools, install Rust/Cargo, Node.js 22.18 or newer, and npm, then run:

make install
make build
make test

For a native example, run node examples/progressive-authoring/run.mjs after building. Progressive authoring in Rust opens a Cut after accepted history, rejects incompatible detail, completes a partial temporal contract, and explicitly revises and continues the same world.

Start the MCP server after building:

cd mcp-server
npm start

See the MCP guide, engine guide, and modeling protocol. Existing life-sim command, schema, resource, and binary identifiers are retained for compatibility with saved artifacts. They do not identify a second engine.

Shortened. The full README is on GitHub.