Metadata-Version: 2.5
Name: byaml-mcp
Version: 0.1.0
Summary: byaml-mcp v2 (ByaML-004) — BYaML Architecture Graph MCP para agentes (Kiro/Cursor/Claude). Graph from evaluation/terraform + insights (blast radius/cost) + remediation.
Author-email: Carlos Cortez <carlos@finoptix.dev>
License: Apache-2.0
License-File: LICENSE
Keywords: architecture,blast-radius,byaml,finops,graph,mcp,sofe
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Requires-Dist: byaml==0.4.0a1
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2,>=1.2
Requires-Dist: nan-graph>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# byaml-mcp v2 (ByaML-004)

MCP server de BYaML Architecture Graph para agentes (Kiro, Cursor, Claude, Copilot).

**El agente NO escribe YAML — usa el grafo.** Input: evaluación/scan/terraform plan.
Output: **Architecture Graph v0.4** + insights (blast radius, costo) + remediación.

## Tools (8)

| Tool | Descripción |
|---|---|
| `graph_from_evaluation` | eval_id/findings → Graph v0.4 |
| `graph_from_terraform` | tfplan.json → Graph v0.4 |
| `graph_from_account` | profile AWS → Graph v0.4 (scan) |
| `validate_graph` | valida grafo (byaml.validate) |
| `blast_radius` | downstream impact de un nodo (nan-graph) |
| `cost_summary` | costo por layer/servicio/owner (nan-graph) |
| `remediation_plan` | findings → pasos IaC (snippet terraform) |
| `schema_latest` | fetch version/catalog del registry schema.byaml.org (ByaML-003) |

## Run

```bash
uv run server.py          # stdio
uvx byaml-mcp             # publicado (PyPI)
```

## Config MCP (Kiro / Claude / Cursor)

```json
{ "mcpServers": { "byaml": { "command": "uvx", "args": ["byaml-mcp"] } } }
```

## Depende de

- `byaml` (PyPI 0.4.0a1) — modelo v0.4 + convert (from_evaluation/from_terraform) + validate
- `nan-graph` (PyPI) — blast_radius, cost_chain, team_cost, SPOF
- `mcp` (FastMCP) — transporte stdio