autocad-site-mcp
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"autocad-site-mcp": {
"command": "npx",
"args": [
"autocad-site-mcp"
]
}
}
}可运行的软件包
0.2.1stdio远程端点
https://acad-qlae.onrender.com/mcpstreamable-http它能做什么
工具清单
工具（19）
⚪cad_new_drawing(name)
Initializes a fresh CAD drawing space, clearing existing entities and resetting layers.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Drawing filename, e.g. \"Structural_Frame.dxf\""
}
}
}🟡cad_add_layers(layers)
Creates or configures CAD layers with custom colors (hex), linetypes (Continuous, Hidden, Center, Phantom), and lineweights (0.18, 0.25, 0.35, 0.50, etc.).
输入模式
{
"type": "object",
"properties": {
"layers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"color": {
"type": "string",
"description": "Hex color or ACI index e.g. \"#ff0000\" or \"#00ffff\""
},
"linetype": {
"type": "string",
"description": "Continuous, Hidden, Center, Phantom"
},
"lineweight": {
"type": "string",
"description": "e.g. \"0.25\", \"0.50\""
}
},
"required": [
"name"
]
},
"description": "List of layer definitions to create"
}
},
"required": [
"layers"
]
}🟡cad_batch_add_entities(entities)
Fast batch insertion of multiple CAD entities (LINE, LWPOLYLINE, CIRCLE, ARC, ELLIPSE, XLINE, RAY, DONUT, SOLID, TRACE, WIPEOUT, SPLINE, ARRAY (associative rect/polar/path), MLINE (multiline), TABLE (title, header and data cells), IMAGE (picture embedded in the drawing), TEXT, MTEXT, DIMENSION, TOLERANCE, LEADER, HATCH (pattern or gradient), POINT, INSERT, POLYLINE3D). LINE, POINT and POLYLINE3D points take z.
输入模式
{
"type": "object",
"properties": {
"entities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "LINE, LWPOLYLINE, CIRCLE, ARC, ELLIPSE, XLINE, RAY, DONUT, SOLID, TRACE, WIPEOUT, SPLINE, ARRAY, MLINE, TABLE, IMAGE, TEXT, MTEXT, DIMENSION, TOLERANCE, LEADER, HATCH, POINT, INSERT, POLYLINE3D"
},
"kind": {
"type": "string",
"description": "ARRAY: rect (rows, cols, rowSpacing, colSpacing), polar (center, count, fill, rotateItems) or path (path, method divide|measure, count|spacing, rows, rowSpacing, align)"
},
"sources": {
"type": "array",
"items": {
"type": "object"
},
"description": "ARRAY: entity definitions that are arrayed"
},
"fitPoints": {
"type": "array",
"items": {
"type": "object"
},
"description": "SPLINE through these points (with optional startTangent, endTangent, knotMethod chord|sqrt|uniform, closed)"
},
"controlPoints": {
"type": "array",
"items": {
"type": "object"
},
"description": "SPLINE control vertices (with degree, optional weights, closed)"
},
"gradient": {
"type": "object",
"description": "HATCH gradient fill: { name: LINEAR|CYLINDER|INVCYLINDER|SPHERICAL|INVSPHERICAL|HEMISPHERICAL|INVHEMISPHERICAL|CURVED|INVCURVED, color1, color2, angle (radians), centered }. Saved to DXF as a solid fill of color1 (AutoCAD 2000 has no gradients)."
},
"leaderStyle": {
"type": "string",
"description": "LEADER: multileader style name"
},
"textSize": {
"type": "number",
"description": "DIMENSION: text height in drawing units (e.g. 120 for a plan in mm); with arrowSize and precision (decimals)"
},
"arrowSize": {
"type": "number",
"description": "DIMENSION: arrowhead size in drawing units"
},
"justification": {
"type": "string",
"description": "TEXT: Left, Center, Right, TL, TC, TR, ML, MC, MR, BL, BC, BR. MLINE: top, zero or bottom"
},
"file": {
"type": "string",
"description": "IMAGE: path of a PNG, JPEG, GIF, BMP or WebP file inside the server folder (embedded in the drawing); or dataUrl / base64 with name; with position, width (default: pixel width) and rotation"
},
"dataUrl": {
"type": "string",
"description": "IMAGE: data:image/...;base64,... picture"
},
"title": {
"type": "string",
"description": "TABLE: title row text"
},
"header": {
"type": "array",
"items": {
"type": "string"
},
"description": "TABLE: header row cells"
},
"data": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "TABLE: data rows (arrays of cell text; MTEXT codes such as \\P allowed)"
},
"columnWidths": {
"type": "array",
"items": {
"type": "number"
},
"description": "TABLE: width of each column (or columns + columnWidth, default 63.5)"
},
"tableStyle": {
"type": "string",
"description": "TABLE: table style name (default Standard); with position, rowLines and rotation"
},
"mlineStyle": {
"type": "string",
"description": "MLINE: multiline style name (default Standard); with points, closed and scale (default 20)"
},
"layer": {
"type": "string"
},
"color": {
"type": "string"
},
"p1": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"p2": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"bulge": {
"type": "number"
}
}
}
},
"closed": {
"type": "boolean"
},
"width": {
"type": "number",
"description": "LWPOLYLINE constant width"
},
"base": {
"type": "object",
"description": "XLINE / RAY start point",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"dir": {
"type": "object",
"description": "XLINE / RAY direction (or give through: {x,y} or angle in radians)",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"inside": {
"type": "number",
"description": "DONUT inside diameter (0 = filled disc)"
},
"outside": {
"type": "number",
"description": "DONUT outside diameter"
},
"center": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"radius": {
"type": "number"
},
"startAngle": {
"type": "number"
},
"endAngle": {
"type": "number"
},
"text": {
"type": "string"
},
"height": {
"type": "number"
},
"dimType": {
"type": "string",
"description": "linear, aligned, radius, diameter, jogged, angular, ordinate, arclength. Optional: textPoint, textAngle and obliqueAngle (radians), jogLine; jogged: centerOverride, jogPoint"
},
"characteristic": {
"type": "string",
"description": "TOLERANCE: position, concentricity, symmetry, parallelism, perpendicularity, angularity, cylindricity, flatness, circularity, straightness, surfaceprofile, lineprofile, runout, totalrunout"
},
"tolerance": {
"type": "string",
"description": "TOLERANCE value, e.g. \"0.1\", \"d0.05M\" (d = diameter, M/L/S = material condition)"
},
"datums": {
"type": "array",
"items": {
"type": "string"
},
"description": "TOLERANCE datum references, e.g. [\"A\", \"B(M)\", \"C\"]"
},
"vertices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
}
}
},
"z": {
"type": "number",
"description": "Z or elevation"
},
"normal": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"description": "Plane normal [x,y,z]"
}
},
"required": [
"type"
]
},
"description": "Array of CAD entity definition objects"
}
},
"required": [
"entities"
]
}🟡cad_create_block(name, entities, basePoint, attributes)
Defines a reusable Block containing geometric entities and optional attribute definitions (ATTDEF).
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Block name, e.g. \"DOOR_900\", \"TITLE_BLOCK\""
},
"entities": {
"type": "array",
"description": "Array of entity definition objects comprising the block"
},
"basePoint": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"description": "Insertion base point"
},
"attributes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"prompt": {
"type": "string"
},
"defaultValue": {
"type": "string"
},
"insertionPoint": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"height": {
"type": "number"
},
"invisible": {
"type": "boolean"
},
"constant": {
"type": "boolean"
}
},
"required": [
"tag"
]
},
"description": "Optional block attribute definitions"
}
},
"required": [
"name",
"entities"
]
}🟡cad_insert_block(name, position, scale, rotationDeg, attributes)
Places an instance (INSERT) of a block into the drawing with transform scale, rotation, and attribute values.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the block to insert"
},
"position": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"description": "Insertion coordinate"
},
"scale": {
"type": "number",
"description": "Uniform scale factor (defaults to 1)"
},
"rotationDeg": {
"type": "number",
"description": "Rotation in degrees CCW"
},
"attributes": {
"type": "object",
"description": "Key-value map of attribute values for ATTDEF tags"
}
},
"required": [
"name",
"position"
]
}⚪cad_generate_parametric(type, params)
Generates complex parametric structures: "structural_grid", "truss", "mechanical_flange", "gear", or "architectural_floorplan".
输入模式
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"structural_grid",
"truss",
"mechanical_flange",
"gear",
"architectural_floorplan"
],
"description": "Type of parametric structure to generate"
},
"params": {
"type": "object",
"description": "Parameters specific to the structure (e.g. baysX, baysY, spacingX, span, height, teeth, module, rooms, etc.)"
}
},
"required": [
"type"
]
}🟢cad_run_commands(commands, select)
Runs AutoCAD command-line input in the current drawing, exactly as typed in the app. Statements are separated by ";" or newlines; inside a statement tokens are separated by spaces and the statement ends with Enter. Example: "LINE 0,0 100,0 100,50; CIRCLE 50,25 10; CHPROP ALL; C red; LAYMRG N DOORS; N WALLS Y; DRAWORDER ALL; F". Every statement ends with Enter, so keep the follow-up answers of one command step in the same statement ("CHPROP ALL; LA WALLS C red"; a question asked after Enter goes in the next statement: "LAYDEL N TEMP; Y"). Objects are selected with ALL or P (previous). Returns the command log and any problems. 3D: points x,y,z; 3DPOLY, ELEV, VIEW (Top, Front, SWiso ...), UCS. 3D solids: BOX, CYL, SPHERE, EXTRUDE, REVOLVE, UNION, SUBTRACT, INTERSECT, MASSPROP. Use cad_list_commands to see every command.
输入模式
{
"type": "object",
"properties": {
"commands": {
"type": "string",
"description": "Command script"
},
"select": {
"type": "object",
"description": "Optional Quick Select filter applied before the script; the commands then act on it (pre-selection, or P for previous). Example: { \"type\": \"CIRCLE\", \"property\": \"radius\", \"op\": \"<\", \"value\": 5 }. Properties: color, layer, linetype, lineweight, length, radius, area, text, height, blockname, measurement. Operators: =, <>, >, <, * (any). Text values accept * and ? wildcards. exclude: true inverts the filter.",
"properties": {
"type": {
"type": "string"
},
"property": {
"type": "string"
},
"op": {
"type": "string"
},
"value": {},
"exclude": {
"type": "boolean"
}
}
}
},
"required": [
"commands"
]
}🟢cad_list_commands(filter)
Lists every implemented AutoCAD command with its aliases and description. Optional filter matches the name, an alias or words in the description (for example "layer" or "dim").
输入模式
{
"type": "object",
"properties": {
"filter": {
"type": "string"
}
}
}🟡cad_execute_script(script)
Executes JavaScript to generate large or procedural geometry (loops, patterns, algorithms) without spending context tokens. Runs in a separate Node process that cannot write files, start programs or read anything outside the CAD sources; 30 s limit. Variables: CAD, M (CADMath), G (CADGeometry), E (CADEntities), S (CADState), D (CADDXF), L (CADLayouts), parametric, solid(recipe) (adds a 3D solid), console. Changes to the drawing are kept.
输入模式
{
"type": "object",
"properties": {
"script": {
"type": "string",
"description": "JavaScript code to execute. Can call S.addEntity(), parametric.*, M.*, E.*, etc."
}
},
"required": [
"script"
]
}🟢cad_open_dxf(filePath)
Opens an existing ASCII DXF file (AutoCAD R12 to 2018+) in place of the current drawing, so it can be edited with cad_run_commands and saved with cad_export_dxf. Returns counts, what was converted, and a warning listing objects that cannot be read (they would be missing from a saved file).
输入模式
{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "Path of the .dxf file inside the server folder (CAD_MCP_OUTPUT_DIR, default: the server working directory), e.g. \"plans/level1.dxf\""
}
},
"required": [
"filePath"
]
}⚪cad_export_dxf(filePath)
Exports the current drawing to a standard AutoCAD 2000 (AC1015) ASCII DXF file compatible with AutoCAD, Civil 3D, SolidWorks, and LibreCAD.
输入模式
{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "Path of the .dxf file inside the output folder (CAD_MCP_OUTPUT_DIR, default: the server working directory), e.g. \"plans/level1.dxf\""
}
},
"required": [
"filePath"
]
}⚪cad_export_svg(filePath, background)
Renders the drawing or paper space layout to an SVG vector file for instant preview and inspection.
输入模式
{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "Path of the .svg file inside the output folder (CAD_MCP_OUTPUT_DIR, default: the server working directory)"
},
"background": {
"type": "string",
"description": "Background color, e.g. \"#ffffff\" (default) or \"#1e1e1e\""
}
},
"required": [
"filePath"
]
}⚪cad_export_stl(filePath, binary, ids, scale)
Exports the closed 3D solids to a binary or ASCII STL file for 3D printing.
输入模式
{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "Path of the .stl file inside the output folder"
},
"binary": {
"type": "boolean",
"description": "Default true; false writes ASCII"
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Solid ids; default all solids"
},
"scale": {
"type": "number",
"description": "Multiplier on the drawing units (default 1)"
}
},
"required": [
"filePath"
]
}🟢cad_solids(action, ids, limit, from)
Inspects 3D solids: list (id, op, volume, bounds), measure (volume, area, centroid) or check (closed, curve error).
输入模式
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"measure",
"check"
],
"description": "Default list"
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Solid ids; default all"
},
"limit": {
"type": "integer",
"description": "Solids per reply, 1 to 50 (default: as many as fit in 900 bytes)"
},
"from": {
"type": "integer",
"description": "Start index; use the reply's next to page"
}
}
}🟢cad_get_stats
Returns comprehensive statistics of the current drawing: entity count, breakdown by type, layers, bounding box extents, blocks, and layouts.
输入模式
{
"type": "object",
"properties": {}
}🟡cad_share_drawing(name, expiresDays, apiUrl)
Shares the current drawing online via Cloudflare D1 storage (autocad.site). Returns view and edit URLs that can be shared with users or other agents.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Optional drawing name (defaults to current drawing name)"
},
"expiresDays": {
"type": "number",
"description": "Expiration in days (e.g. 1, 7, 30; omit or 0 for never)"
},
"apiUrl": {
"type": "string",
"description": "Optional sharing API endpoint (default: \"https://autocad.site\")"
}
}
}⚪cad_open_shared(id, editToken, apiUrl)
Opens a shared drawing from Cloudflare D1 storage into the current CAD session by its share ID or URL.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Share ID (22 chars) or full URL, e.g. \"https://autocad.site/?share=k7Qx...\""
},
"editToken": {
"type": "string",
"description": "Optional edit token if not included in the URL fragment"
},
"apiUrl": {
"type": "string",
"description": "Optional sharing API endpoint (default: \"https://autocad.site\")"
}
},
"required": [
"id"
]
}🟡cad_update_shared(id, editToken, apiUrl)
Uploads and updates the current CAD session drawing to an existing shared drawing using its editToken.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Share ID or full share URL"
},
"editToken": {
"type": "string",
"description": "Edit token"
},
"apiUrl": {
"type": "string",
"description": "Optional sharing API endpoint"
}
},
"required": [
"id",
"editToken"
]
}⚪cad_revoke_shared(id, ownerToken, apiUrl)
Revokes and deletes a shared drawing from Cloudflare D1 storage using its ownerToken.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Share ID or full share URL"
},
"ownerToken": {
"type": "string",
"description": "Owner token received when creating the share"
},
"apiUrl": {
"type": "string",
"description": "Optional sharing API endpoint"
}
},
"required": [
"id",
"ownerToken"
]
}社区
证据