Text File Read And Refactor MCP

Servidor MCP eficiente en tokens basado en Python stdio que expone herramientas seguras de búsqueda, lectura y refactorización de archivos de texto. Las herramientas resuelven automáticamente la marca BOM y la página de códigos del archivo; las herramientas de edición guardan los archivos con su codificación y BOM originales.

Glama.AI

Repositorio de Github

El repositorio de Github es un espejo público curado del proyecto. El desarrollo activo (incluyendo código experimental y notas de investigación privadas) ocurre en un repositorio privado; las instantáneas seleccionadas se publican aquí periódicamente.

Instalación

1. Instalar uv: https://docs.astral.sh/uv/getting-started/installation/

2. Configurar tu cliente MCP para ejecutar el servidor a través de uvx:

{
  "mcpServers": {
    "text-file-read-and-refactor": {
      "command": "uvx",
      "args": [
        "text-file-read-and-refactor-mcp"
      ]
    }
  }
}

Related MCP server: MCP File Context Server

Herramientas

Concepto Slice: un análogo de slice(start: integer, stop: integer) – almacena los índices de inicio y fin de un rango.

Concepto Boundary: un análogo de Boundary(text: string, type: Enum[text, word, dev_word, regex])

Concepto Span: un análogo de Span(left_boundary: Boundary, right_boundary: Boundary). Permite operaciones de búsqueda/reemplazo como «dame el texto entre "my_config_param:" y ";"» o «reemplaza el texto entre "%my_regex_1%" y "%my_regex_2%" con "my_text"».

Herramientas de solo lectura:

• text_file__list_allowed_directories – en pseudocódigo: "text\_file\_\_list\_allowed\_directories() -> List\[directory\_path]"

• text_file__file_content_length – en pseudocódigo: "text\_file\_\_file\_content\_length() -> integer\_characters\_num"

• text_file__read_slice – en pseudocódigo: "text\_file\_\_read\_slice(characters\_slice) -> text"

• text_file__file_lines_num – en pseudocódigo: "text\_file\_\_file\_lines\_num() -> integer\_lines\_num"

• text_file__read_content_by_line_range – en pseudocódigo: "text\_file\_\_read\_content\_by\_line\_range(lines\_slice) -> text"

• text_file__find_text – en pseudocódigo: "text\_file\_\_find\_text(text, type: Enum\[text, word, dev\_word, regex]) -> {found, result?: {slice, lines, text}}"

• text_file__find_all_text_occurrences – en pseudocódigo: "text\_file\_\_find\_all\_text\_occurrences(text, type: Enum\[text, word, dev\_word, regex], result\_index\_start, result\_index\_stop) -> List\[{found, result: {slice, lines, text}}]"

• text_file__expand_slice_to_lines – en pseudocódigo: "text\_file\_\_expand\_slice\_to\_lines(characters\_slice) -> lines\_slice"

• text_file__find_span_boundaries – en pseudocódigo: "text\_file\_\_find\_span\_boundaries(left\_boundary, right\_boundary) -> Tuple\[left\_boundary\_characters\_slice, right\_boundary\_characters\_slice]"

• text_file__find_span_between_boundaries – en pseudocódigo: "text\_file\_\_find\_span\_between\_boundaries(left\_boundary, right\_boundary) -> text". Ejemplo: text_file__find_span_between_boundaries("my_config_param:", ";") devolverá la cadena " my_value".

• text_file__find_span_with_boundaries – en pseudocódigo: "text\_file\_\_find\_span\_with\_boundaries(left\_boundary, right\_boundary) -> text". Ejemplo: text_file__find_span_with_boundaries("my_config_param:", ";") devolverá la cadena "my_config_param: my_value;".

Herramientas de edición:

• text_file__replace_content_by_line_range – en pseudocódigo: "text\_file\_\_replace\_content\_by\_line\_range(text, lines\_slice)"

• text_file__replace_slice – en pseudocódigo: "text\_file\_\_replace\_slice(text, characters\_slice)"

• text_file__replace_text – en pseudocódigo: "text\_file\_\_replace\_slice(old\_text, new\_text)"

• text_file__replace_span_between_boundaries – en pseudocódigo: "text\_file\_\_replace\_span\_between\_boundaries(text, left\_boundary, right\_boundary)".

• text_file__replace_span_with_boundaries – en pseudocódigo: "text\_file\_\_replace\_span\_with\_boundaries(text, left\_boundary, right\_boundary)".

• text_file__patch_spans_by_boundary_patterns – en pseudocódigo: "text\_file\_\_patch\_spans\_by\_boundary\_patterns(List\[Tuple\[text, left\_boundary, right\_boundary]])".

Cengal

Basado en Cengal

Proyectos que usan Cengal

• InterProcessPyObjects – Paquete de alto rendimiento que ofrece una comunicación entre procesos ultrarrápida a través de memoria compartida, permitiendo compartir objetos de Python entre procesos con una eficiencia excepcional.

• cengal_app_dir_path_finder – Módulo de Python que ofrece una API unificada para obtener fácilmente directorios de aplicaciones específicos del sistema operativo, mejorando la gestión de datos en Windows, Linux y macOS.

• cengal_cpu_info – Información extendida y almacenada en caché de la CPU con un formato de salida consistente.

• cengal_memory_barriers – Barreras de memoria multiplataforma rápidas para Python.

• flet_async – envoltorio que hace que Flet sea asíncrono y trae tanto Cengal.coroutines como asyncio a Flet (interfaz de usuario basada en Flutter).

• justpy_containers – envoltorio alrededor de JustPy para aportar más seguridad y características necesarias en producción a JustPy (interfaz de usuario basada en VueJS).

• Bensbach – descompilador de bytecode de Unreal Engine 3 a un script similar a Lisp y compilador de vuelta a bytecode de Unreal Engine 3. Creado con fines de modding de juegos.

• Realistic-Damage-Model-mod-for-Long-War – Mod tanto para el XCOM:EW original como para el mod Long War. Fue creado con Bensbach, que a su vez se creó con Cengal.

• SmartCATaloguer.com – Catálogo basado en TagDB de imágenes (etiquetas), álbumes de música (etiquetas de género) y aplicaciones (categorías).

Licencia

Copyright © 2026 ButenkoMS. Todos los derechos reservados.

Licenciado bajo la Licencia Apache, Versión 2.0.