archlang-mcp — Claude Code MCP server: what it does, how to install
MCP server for drafting architectural floor plans in ArchLang code. Renders layouts to SVG or ASCII and validates geometry without shell access.
claude mcp add archlang-mcp -- npx -y @chanmeng666/archlang-mcpWhat archlang-mcp does
The server acts as a stdio bridge for the @chanmeng666/archlang library. It spawns no child processes. Each tool directly runs an exported core function. Its compile tool renders drawings as SVG or zero-dependency ASCII. Generating PNG images requires the optional @resvg/resvg-js dependency.
Built-in tools inspect layout validity without visual rendering. The describe tool reports room areas and circulation paths. When layouts have collisions, repair shifts furniture away from walls and door swings. The finish routine fills unassigned spaces and generates architectural drawing sheets.
Tool schemas remain inside the agent context window permanently. This overhead is constant. For environments with shell access, running the archlang CLI directly saves prompt space.
What it helps with
- Compile
.archsource code into SVG or ASCII floor plans - Validate door placement and room adjacency against design requirements
- Resolve furniture collisions with walls and opening swings
- Complete floor plans with furniture layouts and room schedules
Example prompts for the agent
- Render the layout from layout.arch into an SVG floor plan
- Run validate on plan.arch to check room connectivity
- Move furniture away from doorways in apartment.arch using repair
How to install archlang-mcp
Platform CLI
claude mcp add archlang-mcp -- npx -y @chanmeng666/archlang-mcpPlatform CLI
codex mcp add mcp -- npx -y @chanmeng666/archlang-mcpConfig file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@chanmeng666/archlang-mcp"
]
}
}
}Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chanmeng666/archlang-mcp"
]
}
}
}Platform CLI
gemini mcp add mcp npx -y @chanmeng666/archlang-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about archlang-mcp
How to install archlang-mcp in Claude Code?
Run claude mcp add archlang-mcp -- npx -y @chanmeng666/archlang-mcp in your terminal.
What does archlang-mcp do?
It gives AI agents tools to parse and render floor plans written in ArchLang. The server outputs vector graphics and corrects room geometry.
Why choose the ArchLang CLI over this MCP server?
The MCP server keeps tool schemas permanently in the model context window. The command-line tool consumes context only when invoked, which saves prompt space whenever shell access is available.
