# Mcp Server Text Editor

> An open source implementation of the Claude built-in text editor tool

- **Type:** MCP server
- **Install:** `agentstack add mcp-bhouston-mcp-server-text-editor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bhouston](https://agentstack.voostack.com/s/bhouston)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bhouston](https://github.com/bhouston)
- **Source:** https://github.com/bhouston/mcp-server-text-editor
- **Website:** https://www.npmjs.com/package/mcp-server-text-editor

## Install

```sh
agentstack add mcp-bhouston-mcp-server-text-editor
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Claude Text Editor MCP Server

[](https://www.npmjs.com/package/mcp-server-text-editor)
[](https://github.com/bhouston/mcp-server-text-editor/actions/workflows/tests.yml)
[](https://github.com/bhouston/mcp-server-text-editor)

  

An open-source implementation of the Claude built-in text editor tool as a [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP) server. This package provides the same functionality as [Claude's built-in text editor tool](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/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](https://docs.anthropic.com/en/docs/build-with-claude/tool-use/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

```bash
# Install from npm
npm install mcp-server-text-editor

# Or with pnpm
pnpm add mcp-server-text-editor
```

## Usage

### Starting the Server

```bash
# Using npx
npx -y mcp-server-text-editor

# Or if installed globally
mcp-server-text-editor
```

### Configuring in Claude Desktop

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

### Tool Commands

#### View

View the contents of a file or directory.

```json
{
  "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.

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

#### String Replace

Replace text in a file.

```json
{
  "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.

```json
{
  "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.

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

## Development

### Prerequisites

- Node.js 18+
- pnpm

### Setup

```bash
# 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:

```bash
# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bhouston](https://github.com/bhouston)
- **Source:** [bhouston/mcp-server-text-editor](https://github.com/bhouston/mcp-server-text-editor)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/mcp-server-text-editor

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bhouston-mcp-server-text-editor
- Seller: https://agentstack.voostack.com/s/bhouston
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
