Metadata-Version: 2.3
Name: amulen-mcp-server
Version: 0.1.1
Summary: MCP server para integración con AMULEN - Sistema de Gestión de Proyectos
Author: Daniel Muñoz
Author-email: Daniel Muñoz <dmunoz@3htp.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.26.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-settings>=2.12.0
Requires-Python: >=3.12
Project-URL: Issues, https://github.com/dmunoz166/amulen-mcp-server/issues
Description-Content-Type: text/markdown

# amulen-mcp-server

**Servidor MCP (Model Context Protocol) para integración con AMULEN — Sistema de Gestión de Proyectos**

Permite a clientes MCP (Kiro, Claude Desktop, Cursor, Zed, etc.) interactuar con la API REST de AMULEN para gestionar proyectos, tableros, tareas y comentarios.

## Instalación rápida

Requiere [uv](https://docs.astral.sh/uv/) y Python >= 3.12.

```bash
uvx amulen-mcp-server
```

## Configuración en MCP Clients

### Variables de entorno requeridas

| Variable | Descripción | Ejemplo |
|---|---|---|
| `AMULEN_BASE_URL` | URL de tu instancia AMULEN | `https://mi-empresa.amulen.app` |
| `AMULEN_EMAIL` | Email de usuario | `usuario@empresa.com` |
| `AMULEN_PASSWORD` | Contraseña | `***` |

Variables opcionales:

| Variable | Default | Descripción |
|---|---|---|
| `AMULEN_TIMEOUT_S` | `20` | Timeout HTTP en segundos |
| `AMULEN_CSRF_TTL_S` | `600` | TTL del cache CSRF en segundos |

### Kiro CLI

Archivo `.kiro/settings/mcp.json`:

```json
{
  "mcpServers": {
    "amulen": {
      "command": "uvx",
      "args": ["amulen-mcp-server"],
      "env": {
        "AMULEN_BASE_URL": "https://mi-empresa.amulen.app",
        "AMULEN_EMAIL": "usuario@empresa.com",
        "AMULEN_PASSWORD": "tu-contraseña"
      }
    }
  }
}
```

### Claude Desktop

Archivo `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "amulen": {
      "command": "uvx",
      "args": ["amulen-mcp-server"],
      "env": {
        "AMULEN_BASE_URL": "https://mi-empresa.amulen.app",
        "AMULEN_EMAIL": "usuario@empresa.com",
        "AMULEN_PASSWORD": "tu-contraseña"
      }
    }
  }
}
```

El mismo formato aplica para Cursor, Zed y otros clientes MCP compatibles.

## Tools disponibles (16)

### Lectura
- `amulen_health` — Verificar conectividad e identificar usuario autenticado
- `amulen_list_projects` — Listar todos los proyectos
- `amulen_get_project` — Obtener detalles de un proyecto
- `amulen_get_project_dashboard` — Métricas y dashboard de un proyecto
- `amulen_list_boards` — Listar tableros de un proyecto
- `amulen_get_board` — Obtener detalles de un tablero
- `amulen_list_tasks` — Listar tareas de un tablero con filtros opcionales
- `amulen_get_task` — Obtener detalles de una tarea
- `amulen_my_tasks` — Listar mis tareas asignadas (cross-proyecto)

### Escritura
- `amulen_create_project` — Crear un nuevo proyecto
- `amulen_update_project` — Actualizar un proyecto existente
- `amulen_create_board` — Crear un nuevo tablero
- `amulen_create_task` — Crear una nueva tarea
- `amulen_update_task` — Actualizar una tarea existente
- `amulen_move_task_state` — Mover tarea a otro estado (TO DO, DOING, DONE, PENDING, BACKLOG)
- `amulen_add_comment` — Agregar comentario a una tarea

### Formato de respuesta

Todas las tools soportan `response_format`: `"markdown"` (default, optimizado para LLMs) o `"json"` (datos estructurados).

## Desarrollo

```bash
git clone <repo-url>
cd amulen-mcp-server
uv sync
uv run mcp dev -e . src/amulen_mcp_server/server_core.py:app
```

## Licencia

MIT
