Metadata-Version: 2.4
Name: umlforge
Version: 0.1.0
Summary: UML Forge MCP connector — AI-powered UML diagram generation for coding agents
Project-URL: Homepage, https://umlforge.dev
Project-URL: Documentation, https://umlforge.dev/docs
License: Proprietary
Keywords: ai,architecture,class-diagram,claude,cursor,diagram,mcp,sequence-diagram,uml
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: mcp[cli]<2.0.0,>=1.27.0
Requires-Dist: pydantic<3.0.0,>=2.7.0
Description-Content-Type: text/markdown

# UML Forge MCP Connector

**AI-powered UML diagram generation for coding agents.**

[UML Forge](https://umlforge.dev) gives Claude Code, Cursor, Windsurf, and any
MCP-compatible coding agent a suite of 13 specialised tools for producing
professional UML diagrams from your codebase, schema, or architecture
descriptions.

## Quick start

**Claude Code:**
```json
{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": ["umlforge"],
      "env": { "UMLFORGE_API_KEY": "your-api-key" }
    }
  }
}
```

**Cursor / Windsurf** — add the same block to your MCP settings.

Get your API key at [umlforge.dev](https://umlforge.dev).

## Tools included

| Tool | Description |
|------|-------------|
| `umlforge_reverse_engineer` | Class, sequence, and state diagrams from a codebase or GitHub URL |
| `umlforge_api_sequence` | Sequence diagrams from OpenAPI / REST endpoints |
| `umlforge_erd_schema` | Entity-relationship diagrams from SQL schema or ORM models |
| `umlforge_state_machine` | State diagrams from business rules or UI flows |
| `umlforge_frontend_components` | Component hierarchy and data-flow diagrams |
| `umlforge_deployment` | Infrastructure and deployment diagrams |
| `umlforge_threat_model` | STRIDE threat model + attack surface diagram |
| `umlforge_event_driven` | Event flow and pub/sub architecture diagrams |
| `umlforge_ai_agent` | Agent topology and tool-call flow diagrams |
| `umlforge_stakeholder_arch` | C4 context diagrams for stakeholder communication |
| `umlforge_living_docs` | Living documentation diagrams synced to code |
| `umlforge_onboarding` | Onboarding maps for new team members |
| `umlforge_suggest` | Recommends the best diagram type for a description |

## Requirements

- Python 3.11+
- An API key from [umlforge.dev](https://umlforge.dev) (free tier available)

## License

Proprietary. The connector is open to install and use with a UML Forge account.
