Aspicio — Claude Code MCP server: what it does, how to install
Extracts structured geometry and PNG renders from DXF or vector PDF drawings directly into your AI coding agent.
claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcpWhat Aspicio does
The TypeScript engine turns vector drawings into structured model data. Instead of feeding messy scans to a multimodal model, the MCP tools pass exact layer details and raw text from TEXT or MTEXT blocks. Dimensions and title blocks arrive as plain strings, preventing vision hallucination.
Available tools include describe_dxf for boundary and layer metadata, render_dxf for PNG output, and view_dxf for in-chat visualization. Three-dimensional models and drawing modifications are out of scope. Aspicio focuses strictly on inspecting existing two-dimensional layouts.
What it helps with
- Extract dimension values and title block text without OCR
- Generate high-resolution PNG renders from vector CAD files
- Inspect layer hierarchies, colors, and boundary dimensions
- Review vector PDF artwork and layout sheets in chat
Example prompts for the agent
- Inspect floorplan.dxf and list all labels found in the title block.
- Run describe_dxf on part.dxf to verify measurement units and bounds.
- Generate a rendered PNG preview of assembly.dxf using render_dxf.
How to install Aspicio
1Platform CLI: remote server
claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcp2Platform CLI
claude mcp add aspicio -- npx -y @aspicio/mcp1Platform CLI: remote server
codex mcp add aspicio --url https://aspicio-api.frontsail.app/mcp2Platform CLI
codex mcp add aspicio -- npx -y @aspicio/mcpConfig file
{
"mcpServers": {
"aspicio": {
"url": "https://aspicio-api.frontsail.app/mcp"
}
}
}{
"mcpServers": {
"aspicio": {
"command": "npx",
"args": [
"-y",
"@aspicio/mcp"
]
}
}
}Config file
{
"servers": {
"aspicio": {
"type": "http",
"url": "https://aspicio-api.frontsail.app/mcp"
}
}
}{
"servers": {
"aspicio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aspicio/mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http aspicio https://aspicio-api.frontsail.app/mcp2Platform CLI
gemini mcp add aspicio npx -y @aspicio/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 Aspicio
How to install Aspicio in Claude Code?
Run claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcp to attach the hosted service. Alternatively, start it locally with claude mcp add aspicio -- npx -y @aspicio/mcp.
What does Aspicio do?
It parses DXF and vector PDF drawings, delivering structured layer data, entity counts, raw text, and PNG previews to AI agents.
Does Aspicio support 3D geometry or file editing?
No, editing CAD files and handling 3D entities are deliberately excluded. The server only performs 2D inspection and rendering.
