Blender 3D Network Visualization
Create stunning 3D network topology visualizations in Blender from CDP/LLDP neighbor data. Network engineers can request topology drawings via natural language, and NetClaw translates neighbor discovery data into 3D rendering commands.
When to Use
- Visualizing network topology in 3D for presentations
- Creating topology diagrams from CDP/LLDP neighbor data
- Exporting network diagrams as PNG images
- Customizing device colors and adding labels
- Demonstrating network architecture to stakeholders
MCP Server
- Server:
blender-mcp (community MCP via uvx)
- Command:
uvx blender-mcp (stdio transport)
- Host: Windows running Blender with BlenderMCP addon (port 9876)
- Requirements: Blender 3.0+, BlenderMCP addon installed and connected
Available Tools
| Tool |
Parameters |
What It Does |
get_scene_info |
None |
Returns current Blender scene objects |
create_object |
type, name, location, scale |
Creates primitives (cube, sphere, cylinder) |
modify_object |
name, position?, rotation?, scale? |
Transform position/rotation/scale |
set_material |
object_name, color, metallic?, roughness? |
Apply colors and materials |
execute_blender_code |
code |
Run arbitrary Python in Blender |
Workflow Examples
Draw Network Topology
# Draw topology from CDP/LLDP data
"Draw the network topology in Blender using CDP data"
# Visualize neighbors for a specific device
"Visualize the CDP neighbors for core-rtr-01 in 3D"
# Create diagram from LLDP data
"Create a 3D network diagram from the LLDP data"
# Quick topology request
"Show me the network topology in Blender"
Export Visualization
# Export as PNG
"Export the Blender scene as topology.png"
# Save the diagram
"Save the network diagram as a PNG file"
# Render to image
"Render the topology to an image"
Customize Visualization
# Color customization
"Color router-1 red"
"Make all switches purple"
"Change the color of the firewalls to orange"
# Add labels
"Add labels to all devices"
"Label each device with its hostname"
# Highlighting
"Highlight router-1"
"Make core-rtr-01 stand out"
Scene Management
# Clear scene
"Clear the Blender scene"
"Reset the 3D view"
# Query scene
"What objects are in the Blender scene?"
"List the devices in Blender"
Device Color Mapping
| Device Type |
Color |
RGB |
| Router |
Blue |
(0.2, 0.4, 0.8) |
| Switch |
Green |
(0.2, 0.7, 0.3) |
| Firewall |
Red |
(0.8, 0.2, 0.2) |
| Access Point |
Yellow |
(0.9, 0.8, 0.2) |
| Unknown |
Gray |
(0.5, 0.5, 0.5) |
Device types are inferred from hostnames:
- Contains "rtr" or "router" → Router
- Contains "sw" or "switch" → Switch
- Contains "fw" or "firewall" or "asa" → Firewall
- Contains "ap" or "wap" or "wireless" → Access Point
Integration with Other Skills
- pyats-run: Query CDP/LLDP neighbor data from live devices
- suzieq-show: Query network state from SuzieQ observability platform
- canvas-a2ui: Alternative 2D visualization in chat
Error Handling
| Error Code |
Meaning |
Resolution |
| CONNECTION_FAILED |
Blender not running or addon not connected |
Start Blender, click 'Connect to Claude' in BlenderMCP panel |
| ADDON_NOT_READY |
Addon not connected |
Press 'N' in Blender, find BlenderMCP tab, click 'Connect' |
| NO_CDP_DATA |
No neighbor data available |
Query network devices first via pyats-run or suzieq-show |
| TIMEOUT |
First command may timeout |
This is normal - retry the same command |
| EXPORT_FAILED |
Export failed (window minimized) |
Ensure Blender window is visible |
Notes
- Read-only operations - no ServiceNow CR gating required
- Maximum 25 devices rendered per topology (performance limit)
- First command may timeout - subsequent commands are faster
- Requires Windows running Blender (WSL connectivity to Windows host)
- All operations logged to GAIT audit trail
1---2name: blender-3d-viz3description: Create 3D network topology visualizations in Blender from CDP/LLDP neighbor data4license: Apache-2.05---6
7# Blender 3D Network Visualization
8
9Create stunning 3D network topology visualizations in Blender from CDP/LLDP neighbor data. Network engineers can request topology drawings via natural language, and NetClaw translates neighbor discovery data into 3D rendering commands.
10
11## When to Use
12
13- Visualizing network topology in 3D for presentations
14- Creating topology diagrams from CDP/LLDP neighbor data
15- Exporting network diagrams as PNG images
16- Customizing device colors and adding labels
17- Demonstrating network architecture to stakeholders
18
19## MCP Server
20
21- **Server**: `blender-mcp` (community MCP via uvx)
22- **Command**: `uvx blender-mcp` (stdio transport)
23- **Host**: Windows running Blender with BlenderMCP addon (port 9876)
24- **Requirements**: Blender 3.0+, BlenderMCP addon installed and connected
25
26## Available Tools
27
28| Tool | Parameters | What It Does |
29|------|------------|--------------|
30| `get_scene_info` | None | Returns current Blender scene objects |
31| `create_object` | type, name, location, scale | Creates primitives (cube, sphere, cylinder) |
32| `modify_object` | name, position?, rotation?, scale? | Transform position/rotation/scale |
33| `set_material` | object_name, color, metallic?, roughness? | Apply colors and materials |
34| `execute_blender_code` | code | Run arbitrary Python in Blender |
35
36## Workflow Examples
37
38### Draw Network Topology
39
40```bash
41# Draw topology from CDP/LLDP data
42"Draw the network topology in Blender using CDP data"
43
44# Visualize neighbors for a specific device
45"Visualize the CDP neighbors for core-rtr-01 in 3D"
46
47# Create diagram from LLDP data
48"Create a 3D network diagram from the LLDP data"
49
50# Quick topology request
51"Show me the network topology in Blender"
52```
53
54### Export Visualization
55
56```bash
57# Export as PNG
58"Export the Blender scene as topology.png"
59
60# Save the diagram
61"Save the network diagram as a PNG file"
62
63# Render to image
64"Render the topology to an image"
65```
66
67### Customize Visualization
68
69```bash
70# Color customization
71"Color router-1 red"
72"Make all switches purple"
73"Change the color of the firewalls to orange"
74
75# Add labels
76"Add labels to all devices"
77"Label each device with its hostname"
78
79# Highlighting
80"Highlight router-1"
81"Make core-rtr-01 stand out"
82```
83
84### Scene Management
85
86```bash
87# Clear scene
88"Clear the Blender scene"
89"Reset the 3D view"
90
91# Query scene
92"What objects are in the Blender scene?"
93"List the devices in Blender"
94```
95
96## Device Color Mapping
97
98| Device Type | Color | RGB |
99|-------------|-------|-----|
100| Router | Blue | (0.2, 0.4, 0.8) |
101| Switch | Green | (0.2, 0.7, 0.3) |
102| Firewall | Red | (0.8, 0.2, 0.2) |
103| Access Point | Yellow | (0.9, 0.8, 0.2) |
104| Unknown | Gray | (0.5, 0.5, 0.5) |
105
106Device types are inferred from hostnames:
107- Contains "rtr" or "router" → Router
108- Contains "sw" or "switch" → Switch
109- Contains "fw" or "firewall" or "asa" → Firewall
110- Contains "ap" or "wap" or "wireless" → Access Point
111
112## Integration with Other Skills
113
114- **pyats-run**: Query CDP/LLDP neighbor data from live devices
115- **suzieq-show**: Query network state from SuzieQ observability platform
116- **canvas-a2ui**: Alternative 2D visualization in chat
117
118## Error Handling
119
120| Error Code | Meaning | Resolution |
121|------------|---------|------------|
122| CONNECTION_FAILED | Blender not running or addon not connected | Start Blender, click 'Connect to Claude' in BlenderMCP panel |
123| ADDON_NOT_READY | Addon not connected | Press 'N' in Blender, find BlenderMCP tab, click 'Connect' |
124| NO_CDP_DATA | No neighbor data available | Query network devices first via pyats-run or suzieq-show |
125| TIMEOUT | First command may timeout | This is normal - retry the same command |
126| EXPORT_FAILED | Export failed (window minimized) | Ensure Blender window is visible |
127
128## Notes
129
130- Read-only operations - no ServiceNow CR gating required
131- Maximum 25 devices rendered per topology (performance limit)
132- First command may timeout - subsequent commands are faster
133- Requires Windows running Blender (WSL connectivity to Windows host)
134- All operations logged to GAIT audit trail
gabrielmoreira