Text File Read And Refactor MCP

토큰 효율적인 Python stdio MCP 서버로, 안전한 텍스트 파일 검색, 읽기 및 리팩토링 도구를 제공합니다. 도구는 자동으로 파일의 BOM과 코드페이지를 해석하며, 편집 도구는 원래 인코딩과 BOM을 유지하여 파일을 저장합니다.

Glama.AI

Github 저장소

Github 저장소는 프로젝트의 선별된 공개 미러입니다. 활발한 개발(실험 코드 및 개인 연구 노트 포함)은 비공개 저장소에서 이루어지며, 선별된 스냅샷이 여기에 주기적으로 게시됩니다.

설치

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

2. uvx를 통해 서버를 실행하도록 MCP 클라이언트를 구성하세요:

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

Related MCP server: MCP File Context Server

도구

Slice 개념: slice(start: integer, stop: integer)의 유사 개념으로, 범위의 시작 및 끝 인덱스를 저장합니다.

Boundary 개념: Boundary(text: string, type: Enum[text, word, dev_word, regex])의 유사 개념입니다.

Span 개념: Span(left_boundary: Boundary, right_boundary: Boundary)의 유사 개념입니다. "my_config_param:"과 ";" 사이의 텍스트를 알려줘 또는 "%my_regex_1%"와 "%my_regex_2%" 사이의 텍스트를 "my_text"로 바꿔줘와 같은 검색/바꾸기 작업을 가능하게 합니다.

읽기 전용 도구:

• text_file__list_allowed_directories - 의사 코드: "text_file__list_allowed_directories() -> List[directory_path]"

• text_file__file_content_length - 의사 코드: "text_file__file_content_length() -> integer_characters_num"

• text_file__read_slice - 의사 코드: "text_file__read_slice(characters_slice) -> text"

• text_file__file_lines_num - 의사 코드: "text_file__file_lines_num() -> integer_lines_num"

• text_file__read_content_by_line_range - 의사 코드: "text_file__read_content_by_line_range(lines_slice) -> text"

• text_file__find_text - 의사 코드: "text_file__find_text(text, type: Enum[text, word, dev_word, regex]) -> {found, result?: {slice, lines, text}}"

• text_file__find_all_text_occurrences - 의사 코드: "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 - 의사 코드: "text_file__expand_slice_to_lines(characters_slice) -> lines_slice"

• text_file__find_span_boundaries - 의사 코드: "text_file__find_span_boundaries(left_boundary, right_boundary) -> Tuple[left_boundary_characters_slice, right_boundary_characters_slice]"

• text_file__find_span_between_boundaries - 의사 코드: "text_file__find_span_between_boundaries(left_boundary, right_boundary) -> text". 예시: text_file__find_span_between_boundaries("my_config_param:", ";")는 문자열 " my_value"를 반환합니다.

• text_file__find_span_with_boundaries - 의사 코드: "text_file__find_span_with_boundaries(left_boundary, right_boundary) -> text". 예시: text_file__find_span_with_boundaries("my_config_param:", ";")는 문자열 "my_config_param: my_value;"를 반환합니다.

편집 도구:

• text_file__replace_content_by_line_range - 의사 코드: "text_file__replace_content_by_line_range(text, lines_slice)"

• text_file__replace_slice - 의사 코드: "text_file__replace_slice(text, characters_slice)"

• text_file__replace_text - 의사 코드: "text_file__replace_slice(old_text, new_text)"

• text_file__replace_span_between_boundaries - 의사 코드: "text_file__replace_span_between_boundaries(text, left_boundary, right_boundary)".

• text_file__replace_span_with_boundaries - 의사 코드: "text_file__replace_span_with_boundaries(text, left_boundary, right_boundary)".

• text_file__patch_spans_by_boundary_patterns - 의사 코드: "text_file__patch_spans_by_boundary_patterns(List[Tuple[text, left_boundary, right_boundary]])".

Cengal

Cengal 기반

Cengal을 사용하는 프로젝트

• InterProcessPyObjects - 고성능 패키지로, 공유 메모리를 통해 프로세스 간 통신을 획기적으로 빠르게 하여 Python 객체를 프로세스 간에 탁월한 효율성으로 공유할 수 있게 합니다.

• cengal_app_dir_path_finder - OS별 애플리케이션 디렉토리를 쉽게 검색할 수 있는 통합 API를 제공하는 Python 모듈로, Windows, Linux, macOS에서 데이터 관리를 향상시킵니다.

• cengal_cpu_info - 일관된 출력 형식의 확장되고 캐시된 CPU 정보입니다.

• cengal_memory_barriers - Python을 위한 빠른 크로스 플랫폼 메모리 배리어입니다.

• flet_async - Flet을 비동기로 만들고 Cengal.coroutines와 asyncio를 모두 Flet(Flutter 기반 UI)에 가져오는 래퍼입니다.

• justpy_containers - JustPy 주변의 래퍼로, JustPy(VueJS 기반 UI)에 더 많은 보안과 프로덕션에 필요한 기능을 제공합니다.

• Bensbach - Unreal Engine 3 바이트코드를 Lisp 유사 스크립트로 디컴파일하고 다시 Unreal Engine 3 바이트코드로 컴파일하는 도구입니다. 게임 모딩 목적으로 제작되었습니다.

• Realistic-Damage-Model-mod-for-Long-War - 원본 XCOM:EW와 Long War 모드 모두를 위한 모드입니다. Cengal로 만들어진 Bensbach를 사용하여 제작되었습니다.

• SmartCATaloguer.com - 이미지(태그), 음악 앨범(장르 태그) 및 앱(카테고리)의 TagDB 기반 카탈로그입니다.

라이선스

Copyright © 2026 ButenkoMS. All rights reserved.

Apache License, Version 2.0에 따라 라이선스가 부여됩니다.