Text File Read And Refactor MCP

Token-efficient Python stdio MCP server exposing safe text-file search, reading, and refactoring tools. Tools automatically resolve the file BOM and codepage; edit tools save files with their original encoding and BOM.

Github repository

Github repository is a curated public mirror of the project. Active development (including experimental code and private research notes) happens in a private repository; selected snapshots are published here periodically.

Installation

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

2. Configure your MCP client to run the server via uvx:

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

Tools

Read-only tools:

• text_file__list_allowed_directories
• text_file__file_content_length
• text_file__read_slice
• text_file__file_lines_num
• text_file__read_content_by_line_range
• text_file__find_text
• text_file__expand_slice_to_lines
• text_file__find_span_boundaries
• text_file__find_span_between_boundaries
• text_file__find_span_with_boundaries

Edit tools:

• text_file__replace_content_by_line_range
• text_file__replace_slice
• text_file__replace_text
• text_file__replace_span_between_boundaries
• text_file__replace_span_with_boundaries
• text_file__patch_spans_by_boundary_patterns

Cengal

Based on Cengal

Projects using Cengal

• InterProcessPyObjects - High-performance package delivers blazing-fast inter-process communication through shared memory, enabling Python objects to be shared across processes with exceptional efficiency.
• cengal_app_dir_path_finder - A Python module offering a unified API for easy retrieval of OS-specific application directories, enhancing data management across Windows, Linux, and macOS
• cengal_cpu_info - Extended, cached CPU info with consistent output format.
• cengal_memory_barriers - Fast cross-platform memory barriers for Python.
• flet_async - wrapper which makes Flet async and brings booth Cengal.coroutines and asyncio to Flet (Flutter based UI)
• justpy_containers - wrapper around JustPy in order to bring more security and more production-needed features to JustPy (VueJS based UI)
• Bensbach - decompiler from Unreal Engine 3 bytecode to a Lisp-like script and compiler back to Unreal Engine 3 bytecode. Made for a game modding purposes
• Realistic-Damage-Model-mod-for-Long-War - Mod for both the original XCOM:EW and the mod Long War. Was made with a Bensbach, which was made with Cengal
• SmartCATaloguer.com - TagDB based catalog of images (tags), music albums (genre tags) and apps (categories)

License

Copyright © 2026 ButenkoMS. All rights reserved.

Licensed under the Apache License, Version 2.0.