Visio Mcp Server

What is Visio Mcp Server about?

Visio Mcp Server provides a programmable interface to control Microsoft Visio on Windows. By exposing actions such as creating files, adding and connecting shapes, inserting text, and exporting diagrams, it lets developers automate diagram workflows without manual UI interaction.

How to use Visio Mcp Server?

1. Install prerequisites – Windows with Visio installed, Python 3.12+, and the pywin32 package.
2. Install the server package:

   pip install pywin32
   pip install mcp-server
   

3. Run the server:

   python visio_mcp_server.py
   

4. Configure MCP in your MCP settings (JSON) to point to the server executable (see serverConfig below).
5. Send JSON‑formatted requests to the server’s API endpoints to perform operations like Create, AddShape, ConnectShapes, etc.

Key features of Visio Mcp Server

• Create new Visio files or open existing ones
• Add a variety of shapes (rectangle, circle, line, …) with custom coordinates and sizes
• Connect shapes with dynamic, straight, or curved connectors
• Insert or update text on individual shapes
• List all shapes and retrieve their IDs
• Save documents, export to image formats, and close files safely
• Extensible via future enhancements (styling, layers, batch ops, headless mode)

Use cases of Visio Mcp Server

• Automated diagram generation for software architecture, flowcharts, or network maps from code or data sources
• Batch processing of Visio files to apply consistent styling or extract shape metadata
• CI/CD pipelines that generate up‑to‑date documentation diagrams on each build
• Integration with other tools (e.g., project‑management systems) to produce visual reports programmatically
• Educational tools that demonstrate diagram concepts by dynamically constructing examples

FAQ from the Visio Mcp Server

• Q: Does the server work on macOS or Linux?
  A: No. It requires Windows and a local installation of Microsoft Visio because it uses the COM interface.
• Q: Which Python versions are supported?
  A: Python 3.12 or later.
• Q: How do I specify a template for a new diagram?
  A: Include template_path in the Create request JSON; if omitted, a blank document is created.
• Q: What happens if I provide an invalid shape type?
  A: The server falls back to a rectangle shape and logs a warning.
• Q: Can the server run without displaying the Visio UI?
  A: Headless operation is planned for future releases; currently Visio UI will be visible.
• Q: How do I troubleshoot COM errors?
  A: Ensure no orphaned Visio processes are running, restart Visio manually if needed, and verify you have permission to launch COM objects.

Visio MCP Server

A MCP server that provides tools for creating and editing Microsoft Visio diagrams programmatically via a standardized API.

Overview

Visio MCP Server allows you to automate Visio diagram creation and editing using Python. It leverages Microsoft's COM interface to control Visio, enabling you to programmatically create diagrams, add shapes, connect them, add text, and more.

Example

Requirements

• Windows operating system
• Microsoft Visio (Professional or Standard) installed
• Python 3.12+
• Python packages:
  • mcp.server
  • win32com.client (pywin32)

Installation

1. Ensure Microsoft Visio is installed on your system
2. Install required Python packages:

pip install pywin32
pip install mcp-server

3. Clone or download this repository
4. Run the server:

python visio_mcp_server.py

Features

The server provides the following functionality:

Creating and Opening Files

• Create new Visio diagrams
• Open existing Visio diagrams

Shape Management

• Add various shapes (Rectangle, Circle, Line, etc.)
• Connect shapes with different connector types
• Add text to shapes
• List all shapes in a document

File Operations

• Save documents to specified locations
• Export diagrams as images
• Close documents safely

MCP Configuration

Option 1: Local Python Server

Add the server to your MCP settings configuration file:

{
  "mcpServers": {
    "ppt": {
      "command": "python",
      "args": ["/path/to/ppt_mcp_server.py"],
      "env": {}
    }
  }
}

Option 2: Using UVX (No Local Installation Required)

If you have uvx installed, you can run the server directly from PyPI without local installation:

{
  "mcpServers": {
    "ppt": {
      "command": "uvx",
      "args": [
        "--from", "office-visio-mcp-server", "visio_mcp_server"
      ]
    }
  }
}

API Reference

Create a Visio File

Creates a new Visio diagram.

{
  "template_path": "[optional] Path to Visio template (.vstx, .vst)",
  "save_path": "[optional] Where to save the file"
}

Example:

{
  "save_path": "C:\\Users\\YourUsername\\Documents\\MyDiagram.vsdx"
}

Open a Visio File

Opens an existing Visio diagram.

{
  "file_path": "Path to the Visio file to open"
}

Add Shape

Adds a shape to a Visio diagram.

{
  "file_path": "Path to the Visio file",
  "shape_type": "Type of shape (Rectangle, Circle, Line, etc.)",
  "x": 1.0,
  "y": 1.0,
  "width": 1.0,
  "height": 1.0
}

Connect Shapes

Connects two shapes in a Visio diagram.

{
  "file_path": "Path to the Visio file",
  "shape1_id": 1,
  "shape2_id": 2,
  "connector_type": "Dynamic, Straight, or Curved"
}

Add Text

Adds text to a shape in a Visio diagram.

{
  "file_path": "Path to the Visio file",
  "shape_id": 1,
  "text": "Text to add to the shape"
}

List Shapes

Lists all shapes in a Visio diagram.

{
  "file_path": "Path to the Visio file"
}

Usage Example

Here's a complete workflow example:

1. Create a new Visio file:

{
  "save_path": "C:\\Diagrams\\FlowChart.vsdx"
}

2. Add a rectangle shape:

{
  "file_path": "C:\\Diagrams\\FlowChart.vsdx",
  "shape_type": "Rectangle",
  "x": 2.0,
  "y": 2.0,
  "width": 1.5,
  "height": 1.0
}

3. Add another shape:

{
  "file_path": "C:\\Diagrams\\FlowChart.vsdx",
  "shape_type": "Circle",
  "x": 5.0,
  "y": 2.0,
  "width": 1.0,
  "height": 1.0
}

4. Get shape IDs:

{
  "file_path": "C:\\Diagrams\\FlowChart.vsdx"
}

5. Connect the shapes:

{
  "file_path": "C:\\Diagrams\\FlowChart.vsdx",
  "shape1_id": 1,
  "shape2_id": 2,
  "connector_type": "Straight"
}

6. Add text to shapes:

{
  "file_path": "C:\\Diagrams\\FlowChart.vsdx",
  "shape_id": 1,
  "text": "Start"
}

Future Features

The following features are planned for future releases:

Enhanced Shape Styling

• Color and fill pattern customization
• Line weight, style, and color options
• Text formatting (font, size, alignment)
• Shadow and 3D effects

Advanced Visio Objects

• Support for layers and pages
• Group creation and manipulation
• Container management
• Text-only shapes and callouts

Template Management

• Template library access
• Custom template creation
• Favorite templates list

Batch Operations

• Bulk shape creation
• Mass formatting changes
• Import from CSV/JSON data sources

Custom Stencil Support

• Loading custom stencils
• Creating and saving custom stencils
• Searching stencil shapes

Diagram Analysis

• Shape relationship analysis
• Path finding between shapes
• Validation against diagram rules

Export Options

• PDF export with options
• SVG export for web use
• PNG/JPG with custom resolution
• Export specific pages or sections

Integration Capabilities

• REST API wrapper
• Webhook support for diagram changes
• Version control integration
• CI/CD pipeline support

Headless Operation

• Server operation without visible Visio UI
• Background diagram processing
• Scheduled operations

Troubleshooting

Common Issues:

1. Visio Not Launching:

   • Ensure Visio is correctly installed and can be opened manually
   • Check that you have sufficient permissions to launch COM applications

2. Template Not Found:

   • The server will create a blank diagram if templates aren't found
   • Specify an absolute path to a template if needed

3. Invalid Shape Type:

   • If a shape type isn't recognized, the server will default to a rectangle
   • Check spelling and case of shape names

4. COM Errors:

   • Restarting Visio manually may help resolve COM interface issues
   • Ensure no existing Visio processes are hanging in Task Manager

License

This project is licensed under the MIT License - see the LICENSE file for details.