# Aspicio

Extracts structured geometry and PNG renders from DXF or vector PDF drawings directly into your AI coding agent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: frontsail-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/frontsail-ai/aspicio
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/aspicio

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://aspicio-api.frontsail.app/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcp
```

2. **Platform CLI**
```bash
claude mcp add aspicio -- npx -y @aspicio/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add aspicio --url https://aspicio-api.frontsail.app/mcp
```

2. **Platform CLI**
```bash
codex mcp add aspicio -- npx -y @aspicio/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aspicio": {
            "url": "https://aspicio-api.frontsail.app/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aspicio": {
            "command": "npx",
            "args": [
                "-y",
                "@aspicio/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aspicio": {
            "type": "http",
            "url": "https://aspicio-api.frontsail.app/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aspicio": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aspicio/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http aspicio https://aspicio-api.frontsail.app/mcp
```

2. **Platform CLI**
```bash
gemini mcp add aspicio npx -y @aspicio/mcp
```

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md