What can you do with this server?

This MCP server lets AI assistants model Domain-Driven Design systems in Context Mapper's CML language and generate diagrams, canvases, and code artifacts from them. * Manage models: create, load, save, and validate CML models; get model statistics * Query the model: list/inspect bounded contexts, aggregates, relationships; search elements by regex pattern * Model bounded contexts: create, update, delete contexts, set responsibilities, vision statements, knowledge levels, and implementation technology * Model aggregates: create/update/delete aggregates and add entities, value objects, DDD-style ID value objects, domain events, commands, and domain services (individually or in bulk via batch creation) * Define context map relationships: Partnership, SharedKernel, and Upstream-Downstream with OHS/PL upstream and ACL/CF downstream patterns, exposed aggregates * Generate diagrams: PlantUML context maps, aggregate class diagrams, full model diagrams, and PNG/SVG context map images (via CLI) * Produce HTML artifacts: interactive, self-contained HTML context map with linked Bounded Context Canvas pages * Work with Bounded Context Canvases: set canvas-only sections, retrieve canvases in DDD Crew JSON/YAML, generate HTML or YAML canvases (saved as sidecar .canvas.yaml files) * Generate code/documentation artifacts via Context Mapper CLI: MDSL contracts, Freemarker templates, ubiquitous language glossary, JHipster JDL, and full domain reports * Manage the CLI: check Java/CLI status, configure paths and timeouts, download the CLI from Maven Central, list available generators * Enforce validity: real-time validation of duplicate names, invalid types, reserved keywords, and auto-escaping of reserved attributes

How do I use context-mapper-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@context-mapper-mcp List all bounded contexts in my model." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

context-mapper-mcp

by thijs-hakkenberg

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Context Mapper MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to work with Domain-Driven Design models using Context Mapper's CML (Context Mapping Language).

Features

Parse and serialize CML files - Full support for Context Mapper's CML syntax
Manage bounded contexts - Create, update, delete bounded contexts
Work with aggregates - Define entities, value objects, domain events, commands, and services
Context map relationships - Define and manage relationships between bounded contexts (Partnership, SharedKernel, Upstream-Downstream with patterns like OHS, PL, ACL, CF)
Generate PlantUML diagrams - Visualize context maps and aggregate structures
Bounded Context Canvas - Create DDD Crew Bounded Context Canvases (v5), derived from the model and enriched with canvas-only sections
HTML artifacts - Interactive, self-contained HTML context map linked to an HTML canvas per bounded context (works offline, no Java needed)
Real-time validation - Catch errors at creation time, not at save time
ID Value Objects - Dedicated tool for creating DDD-compliant identifier types

Related MCP server: RepoMind-MCP

Validation Features

The server validates models in real-time to prevent common CML errors:

Validation	When	Example Error
Duplicate names	On create	`'AgentId' already exists in ContextA...`
Invalid types	On create	`Map<K,V> is not supported in CML...`
Reserved names	On create	`'Resource' is a reserved keyword...`
Reserved attributes	On save	Auto-escaped with `^` prefix

Valid Attribute Types

Primitives: String, int, long, boolean, DateTime, BigDecimal, UUID
Collections: List<Type>, Set<Type>
References: - TypeName (reference to domain objects)

Invalid Types (Rejected)

Map<K,V>, Any, Tuple, Runnable, Callbacks, nested generics

Installation

Claude Code

claude mcp add context-mapper -- npx -y context-mapper-mcp@latest

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "context-mapper": {
      "command": "npx",
      "args": ["-y", "context-mapper-mcp@latest"]
    }
  }
}

Available Tools

Model Management

Tool	Description
`cml_create_model`	Create a new empty CML model
`cml_load_model`	Load a CML file
`cml_save_model`	Save model to disk
`cml_validate_model`	Validate CML syntax and semantics
`cml_get_model_info`	Get model statistics

Query Tools

Tool	Description
`cml_list_bounded_contexts`	List all bounded contexts
`cml_get_bounded_context`	Get context details
`cml_list_aggregates`	List aggregates (optionally filtered by context)
`cml_get_aggregate`	Get aggregate with all its elements
`cml_find_elements`	Search by name pattern (regex)
`cml_list_relationships`	List context map relationships

Context Tools

Tool	Description
`cml_create_context_map`	Create a context map
`cml_create_bounded_context`	Create a bounded context
`cml_update_bounded_context`	Update a bounded context
`cml_delete_bounded_context`	Delete a bounded context

Aggregate Tools

Tool	Description
`cml_create_aggregate`	Create an aggregate
`cml_update_aggregate`	Update an aggregate
`cml_delete_aggregate`	Delete an aggregate
`cml_add_entity`	Add entity to aggregate
`cml_add_value_object`	Add value object
`cml_add_identifier`	Add ID value object (DDD best practice)
`cml_add_domain_event`	Add domain event
`cml_add_command`	Add command
`cml_add_service`	Add domain service
`cml_batch_add_elements`	Batch create multiple domain objects in one call
`cml_delete_entity`	Delete entity
`cml_delete_value_object`	Delete value object
`cml_delete_domain_event`	Delete domain event
`cml_delete_command`	Delete command
`cml_delete_service`	Delete service

Batch Creation (`cml_batch_add_elements`)

Create multiple domain objects in a single call for improved efficiency:

{
  "contextName": "CustomerManagement",
  "aggregateName": "Customer",
  "identifiers": [
    { "name": "CustomerId" }
  ],
  "entities": [
    {
      "name": "Customer",
      "aggregateRoot": true,
      "attributes": [
        { "name": "id", "type": "- CustomerId", "key": true },
        { "name": "email", "type": "String" }
      ]
    }
  ],
  "valueObjects": [
    {
      "name": "Address",
      "attributes": [
        { "name": "street", "type": "String" },
        { "name": "city", "type": "String" }
      ]
    }
  ],
  "domainEvents": [
    { "name": "CustomerRegistered", "attributes": [{ "name": "customerId", "type": "- CustomerId" }] }
  ],
  "commands": [
    { "name": "RegisterCustomer", "attributes": [{ "name": "email", "type": "String" }] }
  ]
}

Benefits:

Faster: Single round-trip instead of 8+ individual calls
Atomic validation: All elements validated before any are created
Error handling: Use failFast: false to collect all errors at once

Relationship Tools

Tool	Description
`cml_create_relationship`	Create context map relationship
`cml_update_relationship`	Update relationship
`cml_delete_relationship`	Delete relationship
`cml_get_relationship`	Get relationship details

Supported relationship types:

Partnership - Symmetric, both contexts cooperate
SharedKernel - Symmetric, shared code/models
UpstreamDownstream - Asymmetric with patterns:
- Upstream: OHS (Open Host Service), PL (Published Language)
- Downstream: ACL (Anticorruption Layer), CF (Conformist)

Generation Tools

Tool	Description
`cml_generate_context_map_diagram`	Generate PlantUML context map
`cml_generate_aggregate_diagram`	Generate aggregate class diagram
`cml_generate_full_diagram`	Generate full model diagram
`cml_generate_context_map_html`	Generate an interactive HTML context map plus a linked canvas page per context

Bounded Context Canvas Tools

Tool	Description
`cml_set_bounded_context_canvas`	Set canvas sections CML cannot express (strategic classification, domain roles, business decisions, assumptions, verification metrics, open questions, extra collaborators and terms)
`cml_get_bounded_context_canvas`	Get a context's canvas in the DDD Crew canonical format (JSON or YAML)
`cml_generate_bounded_context_canvas`	Write canvases as HTML pages or as DDD Crew YAML for one or all contexts

Canvas sections are filled from the model where possible:

Canvas section	Derived from
Purpose	`domainVisionStatement`
Inbound / outbound communication	Context map relationships: downstreams receive the domain events of the upstream's exposed aggregates (all aggregates when none are exposed); commands are attributed to downstreams only when aggregates are exposed explicitly. Relationship patterns (OHS, PL, ACL, CF, Partnership, Shared Kernel) become the relationship label.
Ubiquitous language	Aggregates, entities and value objects (identifier-only value objects are skipped), with their documentation as definition

Explicitly set entries take precedence over derived ones with the same collaborator or term. Canvas data is saved by cml_save_model to a sidecar file next to the model (model.cml → model.canvas.yaml) in the DDD Crew YAML format, one YAML document per bounded context, and loaded again by cml_load_model.

Example CML File

ContextMap ECommerceContextMap {
    type = AS_IS
    contains CustomerManagement, OrderManagement, Inventory

    CustomerManagement [U,OHS,PL] -> [D,ACL] OrderManagement
    OrderManagement [U] -> [D,CF] Inventory
}

BoundedContext CustomerManagement {
    domainVisionStatement = "Manages customer data"
    implementationTechnology = "TypeScript"

    Aggregate Customer {
        Entity Customer {
            aggregateRoot
            key String customerId
            String email
            String firstName
        }

        ValueObject Address {
            String street
            String city
        }

        DomainEvent CustomerRegistered {
            String customerId
            Date registeredAt
        }

        Command RegisterCustomer {
            String email
            String firstName
        }
    }
}

Development

git clone https://github.com/thijs-hakkenberg/contextmapper_mcp.git
cd contextmapper_mcp
npm install
npm run build
npm test

Architecture

Parser: Chevrotain-based lexer and parser for CML syntax
Writer: Serializes model back to CML format
Validation: Checks model consistency and semantic rules
Tools: MCP tool implementations for all operations
Generators: PlantUML diagram generators, HTML context map and Bounded Context Canvas generators, Context Mapper CLI integration

License

MIT

Available Tools

47 tools

cml_add_commandB

Add a command to an aggregate

Inputs: name (required), contextName (required), aggregateName (required), attributes.

cml_add_domain_eventB

Add a domain event to an aggregate

Inputs: name (required), contextName (required), aggregateName (required), attributes.

cml_add_entityC

Add an entity to an aggregate

Inputs: name (required), contextName (required), aggregateName (required), attributes, +1 more.

cml_add_identifierA

Create an ID Value Object following DDD best practices. Use this instead of primitive String IDs to properly model identifiers as Value Objects.

Inputs: name (required), contextName (required), aggregateName (required).

cml_add_serviceC

Add a domain service to an aggregate

Inputs: name (required), contextName (required), aggregateName (required), operations.

cml_add_value_objectC

Add a value object to an aggregate

Inputs: name (required), contextName (required), aggregateName (required), attributes.

cml_batch_add_elementsA

Batch creation of multiple domain objects (entities, value objects, identifiers, events, commands, services) in a single call. More efficient than individual calls. Validates all elements before creating any.

Inputs: contextName (required), aggregateName (required), commands, entities, +5 more.

cml_cli_statusA

Check Context Mapper CLI and Java availability status

Inputs: no named parameters.

cml_configure_cliB

Configure CLI settings (paths, Java home, output directory, timeout)

Inputs: cliDir, timeout, version, javaHome, +1 more.

cml_create_aggregateC

Create a new aggregate in a bounded context

Inputs: name (required), contextName (required), knowledgeLevel, responsibilities.

cml_create_bounded_contextB

Create a new bounded context

Inputs: name (required), knowledgeLevel, responsibilities, domainVisionStatement, +1 more.

cml_create_context_mapC

Create a context map for the model

Inputs: name, state.

cml_create_modelC

Create a new empty CML model

Inputs: name (required).

cml_create_relationshipA

Create a relationship between bounded contexts. Types: Partnership, SharedKernel (symmetric), UpstreamDownstream (asymmetric with optional OHS/PL upstream patterns and ACL/CF downstream patterns)

Inputs: type (required), name, upstream, downstream, +5 more.

cml_delete_aggregateC

Delete an aggregate

Inputs: contextName (required), aggregateName (required).

cml_delete_bounded_contextB

Delete a bounded context and its relationships

Inputs: name (required).

cml_delete_commandB

Delete a command from an aggregate

Inputs: commandName (required), contextName (required), aggregateName (required).

cml_delete_domain_eventB

Delete a domain event from an aggregate

Inputs: eventName (required), contextName (required), aggregateName (required).

cml_delete_entityC

Delete an entity from an aggregate

Inputs: entityName (required), contextName (required), aggregateName (required).

cml_delete_relationshipC

Delete a relationship

Inputs: id (required).

cml_delete_serviceC

Delete a service from an aggregate

Inputs: contextName (required), serviceName (required), aggregateName (required).

cml_delete_value_objectC

Delete a value object from an aggregate

Inputs: contextName (required), aggregateName (required), valueObjectName (required).

cml_download_cliA

Download and install the Context Mapper CLI from Maven Central

Inputs: force, version.

cml_find_elementsA

Search for elements by name pattern (regex supported)

Inputs: pattern (required), elementType.

cml_generate_aggregate_diagramC

Generate a PlantUML class diagram for an aggregate

Inputs: contextName (required), aggregateName (required).

cml_generate_context_map_diagramB

Generate a PlantUML context map diagram

Inputs: includeAggregates.

cml_generate_context_map_imageB

Generate Context Map visualization (PNG/SVG) using Context Mapper CLI. Requires Java 17+ and CLI (auto-downloaded on first use).

Inputs: width, format, height, timeout, +3 more.

cml_generate_from_templateC

Generate output from a custom Freemarker template. Requires Java 17+ and CLI.

Inputs: templatePath (required), timeout, outputDir, outputFileName.

cml_generate_full_diagramB

Generate a PlantUML diagram of the full domain model

Inputs: no named parameters.

cml_generate_full_reportC

Generate comprehensive domain documentation (Markdown) using bundled template. Requires Java 17+ and CLI.

Inputs: timeout, outputDir.

cml_generate_glossaryB

Generate ubiquitous language glossary (Markdown) from domain model using bundled template. Requires Java 17+ and CLI.

Inputs: timeout, outputDir.

cml_generate_jhipster_jdlB

Generate JHipster JDL from domain model using bundled template. Requires Java 17+ and CLI.

Inputs: type, timeout, outputDir.

cml_generate_mdslA

Generate MDSL microservice contracts from Context Map upstream-downstream relationships. Requires Java 17+ and CLI.

Inputs: timeout, outputDir.

cml_get_aggregateB

Get detailed information about an aggregate including entities, value objects, events, and commands

Inputs: contextName (required), aggregateName (required).

cml_get_bounded_contextA

Get detailed information about a bounded context

Inputs: name (required).

cml_get_model_infoC

Get information about the current model

Inputs: no named parameters.

cml_get_relationshipB

Get details of a specific relationship

Inputs: id (required).

cml_list_aggregatesB

List all aggregates, optionally filtered by context

Inputs: contextName.

cml_list_bounded_contextsA

List all bounded contexts in the model

Inputs: no named parameters.

cml_list_generatorsA

List all available generators and their availability status

Inputs: no named parameters.

cml_list_relationshipsC

List context map relationships

Inputs: contextName.

cml_load_modelB

Load a CML model from a file

Inputs: path (required).

cml_save_modelC

Save the current model to a file

Inputs: path.

cml_update_aggregateC

Update an aggregate

Inputs: contextName (required), aggregateName (required), newName, knowledgeLevel, +1 more.

cml_update_bounded_contextC

Update a bounded context

Inputs: name (required), newName, knowledgeLevel, responsibilities, +2 more.

cml_update_relationshipD

Update a relationship

Inputs: id (required), name, upstreamPatterns, exposedAggregates, +1 more.

cml_validate_modelD

Validate the current CML model

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3/5.0

Scored 2026-07-13 15:11 across 47 tools

Disambiguation4/5

Most tools have clear purposes, but the large number (47) and some overlapping concepts (e.g., generate vs. create for context maps) may cause minor confusion. Descriptions help distinguish, but agents might misselect between aggregate-level and full-model diagram generators.

Naming Consistency5/5

All tools use 'cml_' prefix with consistent snake_case and verb_noun pattern (e.g., cml_add_command, cml_delete_aggregate, cml_generate_diagram). No mixing of conventions.

Tool Count3/5

47 tools is high, reflecting comprehensive DDD modeling capabilities. While each tool serves a specific purpose, the count exceeds typical scopes, and some could be consolidated (e.g., separate delete tools for each element type).

Completeness5/5

The tool set covers full lifecycle management for bounded contexts, aggregates, relationships, and elements (commands, events, entities, etc.), plus model validation, file I/O, batch operations, and extensive generation outputs (diagrams, reports, glossary, JDL, MDSL). No obvious gaps.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Product Management McpD
io.github.varvararatta
MCP server for Product Management
Product Management Project Management
2
https://product-management-mcp.mcpize.run/mcp
Toolkien
io.github.epavanello
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Developer Tools Security
1
https://toolkien.dev/mcp
irenictable
org.benevolabs
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Design Tools Workplace & Productivity Software Architecture
2
https://irenictable.benevolabs.org/mcp
Meeba BrainA
io.github.meemoprasad
Repository knowledge graph MCP server for codebase understanding and debugging.
Code Analysis Developer Tools
51
https://meeba-context-mcp-469248886325.us-central1.run.app/mcp

Related MCP Servers

myBrAIn
Knowledge & Memory Developer Tools
lilium360
A
license
Not graded
quality
D
maintenance
MCP server that provides persistent memory and contextual awareness to language models, enabling project onboarding, recall of architectural rules, and code consistency across sessions.
Updated 9 months ago (2026-02-17 08:39 UTC)
32
MIT
RepoMind-MCP
Code Analysis Developer Tools Software Architecture
doridoor
F
license
A
quality
D
maintenance
MCP server for repository mapping, dependency analysis, and architecture diagram generation for JavaScript, TypeScript, and Python projects.
Updated 3 months ago (2026-08-08 12:54 UTC)
4
10 npm
-
ContextForge
Knowledge & Memory Developer Tools Documentation Access
srmackey
A
license
B
quality
B
maintenance
A local MCP server for managing engineering context across Components, Repos, Tasks, and Governance entities. It enables capturing reusable context and composing it per-task with typed relationships and cross-cutting guidelines.
Updated 20 days ago (2026-10-26 15:20 UTC)
36
1
MIT
architect-c4
Software Architecture Version Control Developer Tools
hewimetall
A
license
Not graded
quality
C
maintenance
MCP server that manages C4 architecture models, ADRs, and flow diagrams as TOML files in a docs directory, with git versioning and an HTTP viewer.
Updated 4 months ago (2026-07-28 15:00 UTC)
113 PyPI
MIT

Context Mapper MCP Server

Features

Validation Features

Valid Attribute Types

Invalid Types (Rejected)

Installation

Claude Code

Claude Desktop

Available Tools

Model Management

Query Tools

Context Tools

Aggregate Tools

Batch Creation (cml_batch_add_elements)

Relationship Tools

Generation Tools

Bounded Context Canvas Tools

Example CML File

Development

Architecture

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

myBrAIn

RepoMind-MCP

ContextForge

architect-c4

Batch Creation (`cml_batch_add_elements`)