Skip to main content
Glama

mcp-server-text-editor

by bhouston

Claude Text Editor MCP Server

An open-source implementation of the Claude built-in text editor tool as a Model Context Protocol (MCP) server. This package provides the same functionality as Claude's built-in text editor tool, allowing you to view, edit, and create text files through a standardized API.

Features

  • Identical API to Claude's Text Editor: Implements the exact same interface as Claude's built-in text editor tool
  • MCP Server Implementation: Follows the Model Context Protocol standard for AI tool integration
  • File Operations:
    • View file contents with optional line range specification
    • Create new files
    • Replace text in existing files
    • Insert text at specific line numbers
    • Undo previous edits

Supported Claude Text Editor Versions

This package implements an equivalent tool to the built-in Claude text editor tool versions:

  • text_editor_20241022 (Claude 3.5 Sonnet)
  • text_editor_20250124 (Claude 3.7 Sonnet)

But using the tool name 'text_editor' to avoid name conflicts with built-in Claude tools.

Installation

# Install from npm npm install mcp-server-text-editor # Or with pnpm pnpm add mcp-server-text-editor

Usage

Starting the Server

# Using npx npx -y mcp-server-text-editor # Or if installed globally mcp-server-text-editor

Configuring in Claude Desktop

{ "mcpServers": { "textEditor": { "command": "npx", "args": ["-y", "mcp-server-text-editor"] } } }

Tool Commands

View

View the contents of a file or directory.

{ "command": "view", "path": "/path/to/file.js", "view_range": [1, 10] // Optional: Show lines 1-10 only }
Create

Create a new file with the specified content.

{ "command": "create", "path": "/path/to/file.js", "file_text": "console.log('Hello, world!');" }
String Replace

Replace text in a file.

{ "command": "str_replace", "path": "/path/to/file.js", "old_str": "console.log('Hello, world!');", "new_str": "console.log('Hello, Claude!');" }
Insert

Insert text at a specific line.

{ "command": "insert", "path": "/path/to/file.js", "insert_line": 5, "new_str": "// This line was inserted by Claude" }
Undo Edit

Revert the last edit made to a file.

{ "command": "undo_edit", "path": "/path/to/file.js" }

Development

Prerequisites

  • Node.js 18+
  • pnpm

Setup

# Clone the repository git clone https://github.com/bhouston/mcp-server-text-editor.git cd mcp-server-text-editor # Install dependencies pnpm install # Build the project pnpm build

Scripts

  • pnpm build: Build the TypeScript project
  • pnpm lint: Run ESLint with auto-fixing
  • pnpm format: Format code with Prettier
  • pnpm clean: Remove build artifacts
  • pnpm clean:all: Remove build artifacts and node_modules
  • pnpm test: Run tests
  • pnpm test:coverage: Run tests with coverage report

Testing

This project uses Vitest for testing.

To run the tests:

# Run all tests pnpm test # Run tests with coverage report pnpm test:coverage

The test coverage report will be generated in the coverage directory.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Claude内置文本编辑器工具版本的开源实现:

text_editor_20241022(克劳德 3.5 十四行诗)text_editor_20250124(克劳德 3.7 十四行诗)

  1. 特征
    1. 支持的 Claude 文本编辑器版本
      1. 安装
        1. 用法
          1. 启动服务器
          2. 在 Claude Desktop 中配置
          3. 工具命令
        2. 发展
          1. 先决条件
          2. 设置
          3. 脚本
          4. 测试
        3. 执照
          1. 贡献

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Facilitates integration with the Cursor code editor by enabling real-time code indexing, analysis, and bi-directional communication with Claude, supporting concurrent sessions and automatic reconnection.
              Last updated -
              2
              2
              38
              TypeScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
              Last updated -
              38
              Python
              MIT License
            • -
              security
              F
              license
              -
              quality
              A utility toolkit that enhances Claude's code interaction capabilities by providing seamless tools for Java code analysis, manipulation, and testing workflows.
              Last updated -
              2
              TypeScript
            • -
              security
              A
              license
              -
              quality
              A toolkit for managing Claude desktop app extension configurations, enabling features like Brave search, file operations, Git/GitHub integration, shell access, web scraping, HTTP requests, AWS documentation search, and Obsidian note management.
              Last updated -
              1
              TypeScript
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/bhouston/mcp-server-text-editor'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server