Log inSubmit server
Aspicio logo

Aspicio

Reads DXF and vector PDF files, returning structured drawing facts, PNG renders, and an optional interactive MCP viewer.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Aspicio

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": {
    "aspicio": {
      "command": "npx",
      "args": [
        "-y",
        "@aspicio/mcp"
      ]
    }
  }
}

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

Automated check passed— started and listed 6 tools correctly (2d ago).

Overview

Aspicio MCP server lets AI agents inspect DXF and vector PDF drawings through structured descriptions, rendered images, and an interactive viewer on supported hosts. It uses the Aspicio parse-and-tessellate engine to expose `describe_dxf` and `render_dxf` over local stdio or hosted Streamable HTTP, with `view_dxf` available on the hosted service. Reach for Aspicio when an agent needs drawing facts such as layers, dimensions, text, bounds, and entity counts instead of relying on OCR or visual guessing.

Use cases

  • Inspect DXF title blocks and dimension text without OCR
  • Render engineering drawings for agent visual review
  • Summarize layers, bounds, units, and entity counts
  • Preview remote drawings through hosted MCP
  • Embed drawing inspection into an agent workflow

Key features

  • Structured DXF and vector PDF descriptions
  • PNG drawing rendering
  • Hosted interactive in-chat viewer
  • Local stdio and remote Streamable HTTP access
  • ASCII and binary DXF support
  • Layer colors, entity counts, bounds, and text extraction

Tools6

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

Verified live~1.5k 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.

8/8 checks healthy over the last 46d

What it can do

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

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

Observed 2026-10-26 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 5d ago via OSV.dev · @aspicio/mcp (npm)

Adoption & maintenance

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

GitHub stars6Stargazers on the source repository.
npm downloads516Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.

How Aspicio works

What Aspicio MCP server does

Aspicio turns DXF and vector PDF drawing content into agent-readable outputs. Its MCP tools can describe a drawing as structured facts, render it for visual inspection, and, through the hosted service, present an interactive in-chat viewer. Supported inputs include local files, URLs, and inline DXF content, depending on the connection method.

The description output includes units, bounds, drawing size, layers and their effective colors, entity counts, and extracted text. This can expose title-block text or dimension values directly. Rendered output provides a PNG for model inspection; the hosted viewer adds pan, zoom, layer visibility controls, fullscreen mode, and host light/dark theme support.

How it works

Aspicio parses the supplied bytes into a normalized drawing document, then tessellates that document into batched geometry. The same pipeline supports the MCP server, HTTP API, browser viewer, and headless rendering paths. DXF input can be ASCII or binary. Vector PDF content is supported when the PDF contains drawing artwork or dielines rather than a scanned image.

The stdio server processes local files in place and does not upload the DXF. The hosted MCP endpoint accepts URLs and inline DXF content. URL retrieval includes private-network protection, size limits, redirect validation, and timeouts. The interactive viewer is locked to the drawing returned by its tool call and makes no network requests.

Setup and configuration

For clients that launch local stdio MCP servers, register:

Terminal
npx -y @aspicio/mcp

Claude Code can install the server and bundled skills from the project marketplace:

text
/plugin marketplace add frontsail-ai/aspicio
/plugin install aspicio@aspicio

Codex can add the marketplace and then register the MCP command:

text
codex plugin marketplace add https://github.com/frontsail-ai/aspicio
codex plugin add aspicio@aspicio
codex mcp add aspicio -- npx -y @aspicio/mcp

For a client supporting remote MCP over Streamable HTTP, use https://aspicio-api.frontsail.app/mcp; no local installation is required. The related HTTP API exposes /describe, /render, and /openapi.json.

Tools and capabilities

  • describe_dxf returns drawing metadata, layer information, effective colors, entity counts, and text content.
  • render_dxf produces a PNG representation of the drawing.
  • view_dxf provides the hosted interactive viewer through the MCP Apps extension.
  • HTTP access supports /describe?src=<dxf-url> and /render?src=<dxf-url>&format=png|svg.
  • Drawing content may include lines, arcs, circles, ellipses, polylines, splines, text, dimensions, fills, hatches, and nested blocks. Unsupported entities are counted and reported rather than terminating processing.
  • Multi-page PDFs and multi-sheet DXFs can be described as a whole or scoped to a specific space when using the underlying engine.

Limitations and notes

Aspicio is for reading and rendering drawings, not editing them. Three-dimensional drawing workflows are out of scope. The hosted interactive viewer requires a host that supports the MCP Apps extension; hosts without that extension still receive structured facts from the tool. PDF support targets vector content, not scanned documents.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Aspicio

Aspicio is an MCP server that connects AI agents to DXF and vector PDF drawings through the `describe_dxf` and `render_dxf` tools, with hosted `view_dxf` support. It returns structured facts such as layers, bounds, units, entity counts, effective colors, and text, plus rendered drawing output for visual inspection.

Run `npx -y @aspicio/mcp` and register it with an MCP client that launches stdio servers. Claude Code and Codex also provide project-specific marketplace commands for installing Aspicio and, in Codex, adding the MCP command.

Yes, the stdio server reads local files in process. It accepts ASCII or binary DXF input and does not upload the DXF. The hosted MCP service is intended for URLs and inline DXF content.

Yes, clients that support remote MCP over Streamable HTTP can connect to `https://aspicio-api.frontsail.app/mcp` without installing the local package. The hosted endpoint supports the drawing tools and can provide the interactive viewer on compatible hosts.

No, Aspicio is intended for drawing inspection and rendering, while editing and 3D are out of scope. Its supported reading and rendering coverage includes common 2D entities such as lines, arcs, circles, polylines, text, dimensions, fills, hatches, and nested blocks.

Related MCP servers

All in Architecture & Design All alternatives
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 PreviewAspicio AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aspicio?style=directory)](https://allmcps.com/mcp/aspicio)
HTML Embed
<a href="https://allmcps.com/mcp/aspicio"><img src="https://allmcps.com/api/badge/aspicio?style=directory" alt="Aspicio on AllMCPs" /></a>