iversal CTags (`apt-get install universal-ctags` on Debian/Ubuntu) ## Installation ### Using uv (recommended) When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-chunk-editor*. ### Using PIP Alternatively you can install `mcp-chunk-editor` via pip: ``` pip install mcp-chunk-editor ``` After installation, you can run it as a script using: ``` python -m mcp_chunk_editor ``` ## Configuration ### Configure for Claude.app Add to your Claude settings:

Using uvx

```json "mcpServers": { "chunk-editor": { "command": "uvx", "args": ["mcp-chunk-editor"] } } ```

Using docker

```json "mcpServers": { "chunk-editor": { "command": "docker", "args": ["run", "-i", "--rm", "mcp/chunk-editor"] } } ```

Using pip installation

```json "mcpServers": { "chunk-editor": { "command": "python", "args": ["-m", "mcp_chunk_editor"] } } ```

### Customization - Maximum Chunk Size By default, the server will use a maximum chunk size of 100 lines. This can be customized by adding the argument `--max-chunk-size=200` (for example, to set 200 lines) to the `args` list in the configuration. ## Debugging You can use the MCP inspector to debug the server. For uvx installations: ``` npx @modelcontextprotocol/inspector uvx mcp-chunk-editor ``` Or if you've installed the package in a specific directory or are developing on it: ``` cd path/to/servers/src/chunk-editor npx @modelcontextprotocol/inspector uv run mcp-chunk-editor ``` ## How It Works The chunk editor works by first parsing files with Universal CTags to identify meaningful semantic units like functions, classes, and methods. These semantic units become the chunks that the LLM can operate on. When editing a file: 1. The LLM requests chunks from a file (`read_chunks`) 2. The LLM makes changes to specific chunks (`replace_chunks`) 3. Changes are immediately applied to the file 4. A preview of the changes is returned for verification 5. If needed, the LLM can undo the most recent change (`undo`) This workflow is more efficient and natural for LLMs compared to traditional line-based editors, which require precise line numbers and content hashing. ## Contributing We encourage contributions to help expand and improve mcp-chunk-editor. Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable. For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make mcp-chunk-editor even more powerful and useful. ## License mcp-chunk-editor is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.29:T5e7,## what is MCP Chunk Editor? MCP Chunk Editor is a Model Context Protocol server that provides chunk-oriented text file editing capabilities for Large Language Models (LLMs). It allows LLMs to edit files using semantically meaningful chunks instead of traditional line numbers, enhancing the editing experience. ## how to use MCP Chunk Editor? To use MCP Chunk Editor, you can install it via pip or run it using uv. After installation, you can interact with the server using various commands to read, replace, undo, create, or delete file chunks. ## key features of MCP Chunk Editor? - **Semantic Chunking**: Identifies meaningful code structures for efficient editing. - **Immediate Application**: Changes are applied instantly with a preview for verification. - **Simple Undo**: Easily revert the last change made to a file. - **Efficiency**: Optimized for LLM token usage with incremental updates. ## use cases of MCP Chunk Editor? 1. Editing code files w

#text-editor

Zed

Claude Text Editor MCP Server

MCP Chunk Editor