skema-mcp

Model Context Protocol (MCP) server for Skema — enabling AI agents (Claude Desktop, Cursor, Windsurf, etc.) to interact with, create, and manage Skema architecture diagrams and models.

Installation & Usage

You can run the server directly using npx:

npx -y skema-mcp

Integration with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "skema": {
      "command": "npx",
      "args": [
        "-y",
        "skema-mcp"
      ],
      "env": {
        "SKEMA_BASE_URL": "https://ske.ma"
      }
    }
  }
}

Integration with Cursor / VS Code / Windsurf

Configure an MCP Stdio server with:

• Command: npx
• Args: -y, skema-mcp
• Environment Variables:
  • SKEMA_BASE_URL: Base URL of your Skema instance (default: https://ske.ma)

Environment Variables

| Variable | Description | Default | | --- | --- | --- | | SKEMA_BASE_URL | Endpoint URL of the Skema server instance | https://ske.ma |

Features

• Diagram & Model Management: Fetch, inspect, create, and update Skema models directly from AI prompts.
• Stdio Transport: Standard JSON-RPC stdio interface compatible with all standard MCP hosts.

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for distribution
npm run build

License

MIT