Metadata-Version: 2.4
Name: umlforge
Version: 0.1.9
Summary: UML Forge MCP connector — architecture intelligence, security analysis, and living documentation for engineering teams
Project-URL: Homepage, https://umlforge.dev
Project-URL: Documentation, https://umlforge.dev/docs
License: MIT
License-File: LICENSE
Keywords: ai,architecture,class-diagram,claude,cursor,diagram,mcp,sequence-diagram,uml
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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

<!-- mcp-name: io.github.dave1362/umlforge -->

**Architecture intelligence, security analysis, and living documentation — inside your coding agent.**

[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_suggest` | **Start here.** Describe your goal in plain English — returns the right tool and a ready-to-run call |
| `umlforge_reverse_engineer` | Class, sequence, and state diagrams from a codebase or GitHub URL |
| `umlforge_api_sequence` | Sequence diagrams for request flows across services |
| `umlforge_erd_schema` | Entity-relationship diagrams from domain descriptions or SQL schemas |
| `umlforge_state_machine` | State diagrams from entity lifecycles and business rules |
| `umlforge_frontend_components` | Component hierarchy and interaction diagrams for UI features |
| `umlforge_deployment` | Infrastructure and CI/CD pipeline 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 for LLM pipelines |
| `umlforge_stakeholder_arch` | C4 context diagrams for investors, CTOs, and non-technical stakeholders |
| `umlforge_living_docs` | Update existing diagrams to reflect sprint or PR changes |
| `umlforge_onboarding` | Day-one knowledge-transfer package for new team members |

All tools accept `report_mode=True` to generate a written analysis report
alongside the diagram.

## Requirements

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

## License

MIT — see [LICENSE](LICENSE).
