text-editor: Instructions file for Claude Code

Claude Implementation Guide

This guide shows you how to set up and use the Advanced MCP Text Editor Server with Claude Desktop and Claude Code CLI.

Quick Setup for Claude Desktop

1. Install and Build

# Clone the repository
git clone https://github.com/stat-guy/text-editor.git
cd text-editor

# Install dependencies and build
npm install
npm run build

2. Configure Claude Desktop

Open your Claude Desktop configuration file:

macOS/Linux:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the text-editor server:

{
  "mcpServers": {
    "text-editor": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/text-editor/dist/index.js"]
    }
  }
}

⚠️ Important:

• Use absolute paths (not relative)
• Point to dist/index.js (not src/index.ts)
• Replace /ABSOLUTE/PATH/TO/ with your actual path

3. Restart Claude Desktop

Completely quit and restart Claude Desktop for the changes to take effect.

4. Verify Installation

Look for the "Search and tools" icon (🔍) in Claude Desktop. You should see these 6 tools available:

• view - View files and directories
• str_replace - Replace text in files
• create - Create new files
• insert - Insert text at specific lines
• undo_edit - Revert changes
• file_info - Get file metadata

Quick Setup for Claude Code CLI

1. Add to Local Configuration

# Navigate to your project directory
cd /path/to/your/project

# Add the text-editor MCP server
claude mcp add text-editor node /ABSOLUTE/PATH/TO/text-editor/dist/index.js

# Verify it's connected
claude mcp list

You should see:

text-editor: node /ABSOLUTE/PATH/TO/text-editor/dist/index.js - ✓ Connected

2. Start Using

You can now use text editing commands in Claude Code:

# Start Claude Code in your project
claude code

# Example usage in Claude conversation:
# "Please view the package.json file"
# "Replace 'debug: false' with 'debug: true' in config.js"
# "Create a new file called utils.ts with basic utility functions"