Archlang logo

Archlang

by ChanMeng666

Compile, inspect, validate, repair, and finish ArchLang floor plans through MCP tools.

Install Archlang

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "chanmeng666-archlang": {
      "command": "npx",
      "args": [
        "-y",
        "@chanmeng666/archlang-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 11 tools correctly ().

Overview

ChanMeng666/archlang exposes the ArchLang floor-plan compiler and analysis workflow through MCP over stdio. Agents can compile declarative `.arch` or Plan-JSON input, inspect rooms and circulation, lint and validate plans, apply bounded fixes, and generate repair or completion edits. Use it when an MCP-native host needs architectural plan tooling without invoking a shell; agents with shell access may prefer the ArchLang CLI. Results are returned as structured JSON, with rendered SVG, PNG, text, or plan data available from `compile`.

Use cases

  • Compile a declarative floor plan to SVG or PNG
  • Inspect rooms, areas, adjacency, and circulation
  • Validate a plan against lint, graph, or intent rules
  • Repair furniture placement and apply diagnostic fixes
  • Generate browser links for rendered plans

Key features

  • ArchLang and Plan-JSON compilation
  • Semantic room and circulation inspection
  • Linting, strict validation, scoring, and graph checks
  • Furniture repair and drawing completion
  • LSP completion and browser link generation
  • Source and output SHA-256 hashes

Tools11

What Archlang lets your agent do. Expand a tool for its parameters.

Verified live~3.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Makes network requests · 1Read-only tools · 11
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age129 days
Maintainers1

Observed 2026-11-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · @chanmeng666/archlang-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars89Stargazers on the source repository.
npm downloads7.8kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.

How Archlang works

What ChanMeng666/archlang MCP server does

ChanMeng666/archlang connects MCP hosts to the @chanmeng666/archlang library for authoring and checking architectural floor plans as code. Plans use ArchLang source in a plan "…" { … } structure; compile also accepts the library's Plan-JSON shape.

The server supports both visual output and semantic inspection. It can render SVG, zero-dependency text, PNG, or JSON representations, while other tools report rooms, areas, doors, adjacency, circulation, zones, storeys, floor geometry, and which positions were authored versus derived by the resolver.

How it works

The package is a thin stdio MCP adapter. Each tool calls an exported library function, and the server does not launch a subprocess or write files. At initialization it provides a short workflow hint: read the archlang://spec resource, create or edit .arch source, compile and fix it, describe the result, then validate with strict: true before finishing or exporting.

Tool calls that receive source include a SHA-256 source_hash in their result. Rewriting tools—repair, fix, and finish—also return an output_hash for the exact replacement text. These hashes support stale-source checks when the returned text is written back through the CLI.

Setup and configuration

Run the local server with npm and npx:

Terminal
npx -y @chanmeng666/archlang-mcp

A hosted MCP endpoint is also available at https://mcp.archlang.uk/mcp. Claude-compatible coding agents can add either the HTTP endpoint or the local stdio command. The package is intended for MCP-speaking hosts; VS Code also provides an ArchLang extension through its Marketplace and Open VSX listings.

Tools and capabilities

  • compile renders source or Plan-JSON as SVG, text, JSON, or PNG. Multi-storey plans return all levels in pages[], or one level when level is selected. accessible adds SVG title, description, and image role metadata, while overlay: "circulation" adds a circulation overlay.
  • describe returns semantic plan facts without requiring image interpretation.
  • lint emits advisory soundness warnings, with selectable profiles.
  • validate combines parsing, resolution, and linting. It can enforce warnings as failures, check an intended room graph, evaluate an intent contract, and report the next item to address.
  • score measures how much of a brief the plan satisfies without acting as a gate.
  • repair moves furniture away from walls, doorways, and door swings, but does not add doors or windows.
  • finish furnishes empty rooms and adds missing sheet elements such as paper, scale, dimensions, title, room schedule, and legend.
  • fix applies machine-applicable diagnostic fixes; suggest proposes door or window statements without applying them.
  • complete provides language-server completion items, and link creates browser URLs for the hosted playground and standalone embedded plan.

Limitations and notes

PNG output requires the optional @resvg/resvg-js package; the .mcpb bundle excludes it. The MCP accessibility option only adds root SVG title, description, and image-role metadata. It does not expose the library's element-level keyboard and screen-reader controls or the multi-plan idPrefix option.

The 3D preview belongs to the separate archlang-3d package rather than this MCP server. Its documented scope excludes pitched roofs, balcony railings, sections, elevations, and BIM. For agents that already have shell access, the ArchLang CLI is described as the primary interface and can compile files directly; this MCP package is intended for MCP-native hosts and discovery.

Written by AllMCPs with AI assistance from the project’s README and listing data. How we build listings

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Archlang

ChanMeng666/archlang is an MCP server that connects MCP hosts to the ArchLang floor-plan library. Its main tools compile `.arch` or Plan-JSON plans, describe rooms and circulation, lint and validate geometry, repair or finish source, apply diagnostic fixes, suggest openings, provide completions, and create browser links.

Install it with `npx -y @chanmeng666/archlang-mcp` and register that command as a local stdio MCP server. A hosted endpoint is also available at `https://mcp.archlang.uk/mcp`, which can be added to compatible clients using HTTP.

Yes, it uses standard MCP transports and can be used by MCP clients such as Cursor. The local package runs over stdio, while the hosted service uses the `https://mcp.archlang.uk/mcp` endpoint.

Use the MCP server when the agent host is MCP-native and has no shell workflow. If the agent already has shell access, the ArchLang CLI is the preferred interface because its context is loaded when called rather than held in the MCP tool schema.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewArchlang AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/chanmeng666-archlang?style=directory)](https://allmcps.com/mcp/chanmeng666-archlang)
HTML Embed
<a href="https://allmcps.com/mcp/chanmeng666-archlang"><img src="https://allmcps.com/api/badge/chanmeng666-archlang?style=directory" alt="Archlang on AllMCPs" /></a>