Ilograph

The Ilograph MCP Server lets your AI agents access up-to-date Ilograph documentation, validation tooling, and diagram guidance through a streamlined MCP connection. It enables automated diagram creation, real-time validation, and rich documentation access, all via MCP-compatible clients.

How to use

Connect to the Ilograph MCP Server from an MCP client such as VS Code, Claude Desktop, Cursor, or JetBrains AI Assistant. You will run a local or remote MCP server instance and register it in your client so you can request live documentation, validation, and diagram examples. Once connected, you can:

• Fetch up-to-date Ilograph documentation and best practices
• Validate diagrams against Ilograph schemas with helpful error messages
• Explore curated diagram examples and learn from explanations
• Search for icons and resources to enrich your diagrams Use these capabilities to accelerate diagram creation and improve correctness in your Ilograph projects.

How to install

Prerequisites you need before starting:

• Docker installed and running on your machine
• An MCP-compatible client (for example, VS Code with the MCP extension, Claude Desktop, Cursor, or JetBrains AI Assistant) ready to connect to an MCP server.

Start the Ilograph MCP Server using Docker. Run this command in your terminal to launch the server image in a disposable container for immediate use.

{
  "mcpServers": {
    "ilograph": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
      ]
    }
  }
}

Optionally, you can add a similar configuration in your workspace settings to share with teammates. The following snippet integrates the same Docker-based start into your VS Code MCP settings.

{
  "servers": {
    "ilograph": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
      ]
    }
  }
}

If you are using Claude Desktop, Cursor, or JetBrains AI Assistant, you can configure the MCP connection similarly by placing this in your MCP settings.

{
  "mcpServers": {
    "ilograph": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"]
    }
  }
}

Additional setup tips

Verify the server is reachable from your MCP client after starting. If connection issues occur, ensure Docker is running, the image pulls successfully, and your client is configured to reach the appropriate MCP endpoint. You can test basic access by issuing a simple documentation fetch or a validation request once connected.

Notes and best practices

This MCP server provides educational and development-oriented access to Ilograph resources. Outputs and recommendations can vary based on inputs, so review results for alignment with your project requirements and cross-check against official Ilograph documentation before applying changes to production diagrams.

Troubleshooting

If you encounter problems connecting to the MCP server, check:

• Docker is installed and running
• The correct image tag is used (latest in examples)
• Your MCP client is configured to point to the server as shown in the connection snippets
• There are no port or network restrictions blocking container communication

Security and maintenance

Keep your MCP server image up to date by pulling the latest container image when you’re ready to upgrade. Do not expose the server publicly without proper access controls. Regularly review outputs for accuracy and validate against trusted documentation sources.

Examples and workflows

Leverage the server to fetch documentation for a specific topic, validate a diagram against Ilograph schema, or retrieve an example diagram with learning context. Combine these capabilities to rapidly prototype diagrams and learn best practices.

Available tools

fetch_documentation_tool

Fetches comprehensive documentation from Ilograph's official sources with intelligent caching

list_documentation_sections

Lists all available documentation sections with descriptions and coverage areas

check_documentation_health

Performs health checks and returns cache statistics for documentation service

fetch_spec_tool

Fetches the official Ilograph specification with complete property definitions and types

check_spec_health

Performs health checks specifically on the specification service connectivity

list_examples

Lists available Ilograph example diagrams categorized by complexity and use case

fetch_example

Retrieves specific example diagrams with metadata, learning context, and explanations

validate_diagram_tool

Validates Ilograph diagram syntax and provides detailed error messages with suggestions

get_validation_help

Provides comprehensive guidance on diagram validation and common issues resolution

search_icons_tool

Searches the live Ilograph icon catalog with semantic matching and provider filtering

list_icon_providers_tool

Lists all available icon providers (AWS, Azure, GCP, etc.) and their service categories