Metadata-Version: 2.4
Name: akima-sc-doc-mcp
Version: 1.1.0
Summary: Servidor MCP para actualizar diccionarios canónicos desde Excel, validar Swagger/OpenAPI, exportar reportes de validación a Excel, crear páginas de documentación de APIs en Confluence y generar documentos Word de entrega de software (API Connect / DataPower)
Author: Equipo Servicios Compartidos
License-Expression: LicenseRef-Proprietary
Keywords: avc,confluence,datapower,diccionario,documentacion,docx,entrega,kiro,mcp,openapi,swagger,validacion,word
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary 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.10
Requires-Dist: mcp<2.0.0,>=1.0.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# Akima SC Doc MCP Server

Servidor MCP para el Kiro Power "akima-sc-doc". Proporciona herramientas para:

- **Actualizar diccionarios** desde archivo Excel canónico
- **Listar diccionarios** disponibles en el workspace
- **Exportar reportes de validación** a Excel (.xlsx)
- **Crear páginas de documentación de APIs** en Confluence
- **Generar documentos Word de entrega de software** (API Connect y DataPower) a partir de plantillas `.docx`

## Instalación

```bash
pip install akima-sc-doc-mcp
```

O con uv (recomendado para Kiro):
```bash
uv akima-sc-doc-mcp
```

## Uso con Kiro

Este servidor se configura automáticamente al instalar el power "akima-sc-doc".

## Herramientas disponibles

- `actualizar_diccionario` — Actualiza diccionarios desde Excel
- `listar_diccionarios` — Lista diccionarios en el directorio de steering
- `exportar_reporte_validacion` — Exporta reporte de validación a Excel
- `crear_pagina_confluence` — Crea página de documentación de API en Confluence a partir de un Swagger
- `generar_documento_entrega_api` — Genera el documento Word "Entrega de Software API" (.docx) desde un template, con contingencia extraída de los JSON de despliegue
- `generar_documento_entrega_dp` — Genera el documento Word "Entrega de Software DataPower" (.docx) desde un template, con soporte de valores multi-línea y reemplazo tolerante a la fragmentación de runs de Word

## Licencia

**Propietario — Todos los derechos reservados.**

© 2025 ADL Digital Labs / Grupo AVAL. Uso exclusivo interno.

Este software es propiedad de ADL Digital Labs y Grupo AVAL. Queda prohibida su copia, distribución, modificación o uso fuera del ámbito corporativo sin autorización expresa.

## Build y publicación en PyPI

### Requisitos

- [uv](https://docs.astral.sh/uv/getting-started/installation/) (gestor de paquetes Python)

### Instalar herramientas de build

```bash
uv tool install build && uv tool install twine
```

### Generar artefactos (sdist + wheel)

```bash
pyproject-build powers/akima-sc-doc/mcp-server/
```

Esto genera los archivos `.tar.gz` y `.whl` en el directorio `dist/`.

### Subir a PyPI

```bash
twine upload powers/akima-sc-doc/mcp-server/dist/*
```

> Requiere tener configuradas las credenciales de PyPI (token o usuario/contraseña en `~/.pypirc`).

### Verificar publicación

```bash
pip index versions akima-sc-doc-mcp
```