Claude Text Editor MCP Server

Claude 文本编辑器 MCP 服务

这是一个开源实现，将 Claude 内置文本编辑器工具作为 Model Context Protocol（MCP）服务提供。该软件包提供与 Claude 内置文本编辑器工具相同的功能，让你能够通过标准化 API 查看、编辑和创建文本文件。

功能

• 与 Claude 文本编辑器的 API 完全一致：实现与 Claude 内置文本编辑器工具完全相同的接口
• MCP 服务实现：遵循 Model Context Protocol 标准，以集成 AI 工具
• 文件操作：
  • 查看文件内容，可选择指定行范围
  • 创建新文件
  • 替换现有文件中的文本
  • 在指定行号插入文本
  • 撤销之前的编辑

支持的 Claude 文本编辑器版本

此软件包实现了与以下版本的内置 Claude 文本编辑器工具等效的工具：

• text_editor_20241022（Claude 3.5 Sonnet）
• text_editor_20250124（Claude 3.7 Sonnet）

但使用工具名称“text_editor”，以避免与 Claude 内置工具名称冲突。

安装

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

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

使用方法

启动服务

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

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

在 Claude Desktop 中配置

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

工具命令

查看

查看文件或目录的内容。

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

创建

使用指定内容创建新文件。

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

字符串替换

替换文件中的文本。

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

插入

在指定行插入文本。

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

撤销编辑

撤销对文件所做的上一次编辑。

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

开发

前置条件

• Node.js 18+
• pnpm

设置

# 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

脚本

• pnpm build：构建 TypeScript 项目
• pnpm lint：运行 ESLint 并自动修复
• pnpm format：使用 Prettier 格式化代码
• pnpm clean：移除构建产物
• pnpm clean:all：移除构建产物和 node_modules
• pnpm test：运行测试
• pnpm test:coverage：运行测试并生成覆盖率报告

测试

此项目使用 Vitest 进行测试。

运行测试：

# Run all tests
pnpm test

# Run tests with coverage report
pnpm test:coverage

测试覆盖率报告将生成在 coverage 目录中。

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request