Skip to main content

Herramientas y recursos de MCP

Las herramientas realizan acciones en el CODESYS El proyecto y los resultados se muestran en la tabla. Las herramientas de lectura no afectan al proyecto. Las herramientas de escritura modifican permanentemente el contenido o la estructura del proyecto, y se indican como tales en la tabla.

Herramienta

Descripción

Efecto

browse_project_tree

Muestra la estructura del árbol del proyecto o de un subárbol específico. Opcionalmente, los métodos, las propiedades y las acciones se muestran debajo de sus POU principales.

Solo lectura

get_active_app_as_path

Devuelve la ruta del proyecto cargado actualmente.

Solo lectura

get_active_path_and_selection

Devuelve la ruta de la selección activa en CODESYS Cuando se selecciona un código, también se devuelven los números de línea y el texto seleccionado.

Solo lectura

search_path_by_glob

Utiliza patrones glob para encontrar objetos en el árbol del proyecto. En caso de que haya varios resultados con un ancestro común, la salida se muestra agrupada.

Solo lectura

search_in_files_by_regex

Utiliza patrones glob para encontrar objetos en el árbol del proyecto. En caso de que haya varios resultados con un ancestro común, la salida se muestra agrupada.

Solo lectura

get_structured_text_content

Devuelve el código fuente de texto estructurado de un objeto en la ruta especificada. Los subobjetos anidados (por ejemplo, métodos, acciones, propiedades y transiciones) se incluyen en la salida de forma predeterminada.

Solo lectura

create_or_replace_structured_text_object

Crea nuevos objetos de texto estructurado o reescribe por completo los existentes. Se puede crear un POU completo con sub-POU anidados en una sola llamada. Los sub-POU que no se incluyan explícitamente se conservarán.

Los objetos existentes en la misma ruta serán sobrescritos.

replace_text_in_structured_text

Realiza sustituciones de texto específicas en un objeto de texto estructurado.

El texto especificado se sustituirá en el objeto de destino.

create_folder

Crea una nueva carpeta en el árbol del proyecto. Esta herramienta se utiliza para organizar las POU en grupos lógicos.

Se creará una nueva carpeta en el proyecto.

remove_object

Elimina un objeto del proyecto. La herramienta también se utiliza para eliminar sub-POU individuales de un bloque de función.

El objeto será eliminado de forma irreversible.

add_program_call_to_task

Asigna un programa a una tarea para que se ejecute durante el ciclo de ejecución. Esta herramienta se utiliza después de crear un nuevo programa.

Se añadirá una nueva llamada al programa en la tarea.

check_for_errors

Comprueba si hay errores en el proyecto y devuelve mensajes de diagnóstico con las rutas de origen y los números de línea. En modo estándar, la herramienta utiliza reglas de precompilación. Opcionalmente, se puede iniciar una compilación completa.

Solo lectura. Opcionalmente, la herramienta puede iniciar la compilación del proyecto.

get_available_libraries_list

Devuelve una lista de todas las bibliotecas disponibles en CODESYS.

Solo lectura

get_libraries_referenced_in_application

Devuelve una lista de todas las bibliotecas a las que se hace referencia en la aplicación.

Solo lectura

add_library

Agrega una referencia a la biblioteca del proyecto.

Se añadirá una nueva referencia al Administrador de la Biblioteca.

get_library_documentation

Proporciona una descripción general concisa del contenido de una biblioteca. Contiene todas las funciones, tipos y sus firmas de nivel superior.

Solo lectura

get_detailed_library_documentation

Devuelve documentación detallada para funciones específicas de una biblioteca. Incluye parámetros, tipo de retorno y otros detalles relevantes.

Solo lectura

search_liebraries_for_type

Busca un tipo o función por nombre en todas las bibliotecas disponibles. Devuelve el nombre de la biblioteca y el tipo de elemento.

Solo lectura

get_device_and_io_configuration

Devuelve el árbol de dispositivos completo y la configuración de E/S de todos los dispositivos del proyecto. Incluye conectores, canales de E/S, asignaciones a variables e información del dispositivo.

Solo lectura