mcp-registry/mcp-text-editor

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-text-editor

by tumf

Model Context Protocol (MCP) server offering safe, line-oriented text-file editing with token-efficient partial-file access, designed for integration with LLM tools.

140
17
Open Source
GitHub

01

get_text_file_contents

Retrieve the contents of one or more text files, optionally limited to specific line ranges and supporting various encodings.

02

patch_text_file_contents

Apply line-based patches to one or more text files with hash-based conflict detection and error handling.

03

edit_text_file_contents

Edit text files by submitting patches that replace or append specific line ranges.

Installation

1. Clone the repository:
git clone https://github.com/tumf/mcp-text-editor.git cd mcp-text-editor
2. Create and activate a virtual environment (recommended):
python -m venv .venv source .venv/bin/activate # on Windows: .venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
4. Launch the server (typical entry-point—adjust if the package exposes a different module):
python -m mcp_text_editor
5. Configuration:
• Environment variables such as MCP_HOST and MCP_PORT can be exported to change the bind address/port.
• If the project provides a config.yaml or .env file, copy the sample (cp config.sample.yaml config.yaml) and edit as needed.
6. Visit the advertised port (default http://localhost:8000) to start using the MCP Text Editor interface.

Documentation

License: MIT License
Updated 7/30/2025