Archlang MCP logo

Archlang MCP

Compile and inspect ArchLang text floor plans over stdio, with validation and repair workflows that export SVG drawings.

Install Archlang MCP

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": {
    "archlang-mcp": {
      "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 (Today).

Overview

archlang-mcp exposes ArchLang floor-plan workflows to agents through the Model Context Protocol over stdio. It can compile `.arch` source into SVG, describe plans, lint and validate them, then repair or fix issues identified during checking. Reach for it when an agent needs to create or iteratively review a dimensioned floor plan as text rather than manipulate an image. The package runs through `npx`, making it suitable for MCP clients that support stdio servers.

Use cases

  • Write a floor plan from a room and adjacency brief
  • Compile `.arch` source into an SVG drawing
  • Validate a generated plan before delivery
  • Repair plan errors and recompile the result

Key features

  • ArchLang `.arch` floor-plan compilation
  • SVG drawing output
  • Plan description and linting
  • Strict validation with JSON output
  • Automated repair and fix workflow
  • Stdio-based MCP operation

Tools11

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

Verified live~2.9k 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 Today

Recent health check succeeded.

22/22 checks healthy over the last 94d

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 age124 days
Maintainers1

Observed 2026-11-12 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 9d ago via OSV.dev · @chanmeng666/archlang-mcp (npm)

Adoption & maintenance

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

GitHub stars35Stargazers on the source repository.
npm downloads3.5kPackage 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.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Archlang MCP works

What archlang-mcp does

archlang-mcp gives an MCP-compatible agent access to ArchLang, a text-based language for describing floor plans. It supports the main loop of writing a .arch file, compiling it into an SVG drawing, inspecting the result, and correcting problems. The workflow is intended for floor-plan source that should remain editable and reviewable as code.

The server covers compilation, description, linting, validation, repair, and fixing. Validation can be run in strict mode, and JSON output is available for command workflows that need structured results. ArchLang’s source-driven model also supports repeatable output: changing a dimension or other value updates the corresponding drawing while keeping the rest of the plan derived from the same source.

How it works

The MCP client starts the server as a stdio process. An agent can then use the exposed operations to work through a plan without opening a graphical editor. A typical sequence is:

  1. Read the ArchLang language specification.
  2. Write a floor plan to a .arch source file.
  3. Compile the source to an SVG.
  4. Describe the plan and run strict validation.
  5. Apply repairs or fixes, then compile again.

Compilation errors carry information that can guide the next correction. The resulting SVG is the primary drawing format described for this MCP workflow. ArchLang itself also documents export paths including DXF, PDF, and PNG.

Setup and configuration

Install and start the MCP package with npx:

Terminal
claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp

The command registers a server named archlang for the Claude command-line client and runs the package without requiring a separate global installation. Other MCP clients can use the same package as a stdio server when configured with the equivalent command and arguments.

For agents that need language guidance before generating a plan, ArchLang provides specification and context commands through its CLI. The recommended authoring process reads the specification first, creates the .arch file, and then checks the generated plan before exporting it.

Tools and capabilities

  • Compile ArchLang .arch floor plans into SVG drawings.
  • Describe the contents or structure of a floor-plan source file.
  • Lint source plans for issues during authoring.
  • Validate plans, including strict validation with structured JSON output.
  • Repair or fix problems found in an ArchLang plan.
  • Support an iterative text-to-drawing workflow for dimensioned floor plans.

Limitations and notes

The server is focused on ArchLang floor-plan source and communicates over stdio. It is a fit for agents that can launch local MCP processes and work with files or command results. The workflow depends on ArchLang syntax, so agents should consult the language specification or context before generating nontrivial plans. SVG is the directly described MCP compilation result; additional formats are associated with the underlying ArchLang CLI.

Reviews

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

Frequently Asked Questions about Archlang MCP

archlang-mcp is an MCP server that connects AI agents to the ArchLang floor-plan language through stdio. Its main tools compile `.arch` source into SVG, describe plans, lint and validate them, and repair or fix issues so agents can create and check text-based floor plans.

Install it for Claude with `claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp`. The command launches the package through `npx` as a stdio MCP server, without requiring a global package installation.

Yes. Cursor can use archlang-mcp when configured to launch its stdio command, `npx -y @chanmeng666/archlang-mcp`. The server then exposes ArchLang compilation, description, linting, validation, and repair capabilities to the client.

Yes. archlang-mcp supports plan validation, including strict validation and JSON-formatted results. An agent can compile a `.arch` file, inspect or validate it, apply fixes, and compile the corrected source again.

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 MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/archlang-mcp?style=directory)](https://allmcps.com/mcp/archlang-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/archlang-mcp"><img src="https://allmcps.com/api/badge/archlang-mcp?style=directory" alt="Archlang MCP on AllMCPs" /></a>