amulen-mcp-server 0.1.0

MCP server para integración con AMULEN - Sistema de Gestión de Proyectos

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 y Python >= 3.12.

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	[e-mail]
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:

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

Claude Desktop

Archivo claude_desktop_config.json:

{
  "mcpServers": {
    "amulen": {
      "command": "uvx",
      "args": ["amulen-mcp-server"],
      "env": {
        "AMULEN_BASE_URL": "https://mi-empresa.amulen.app",
        "AMULEN_EMAIL": "[e-mail]",
        "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

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