MCP文本编辑器服务器
实现Anthropic文本编辑器工具功能的模型上下文协议（MCP）服务器。此服务器允许Claude和其他MCP客户端读取和修改指定目录中的文件。
特性
服务器实现了与Anthropic的文本编辑器工具相同的命令，以及增强的编辑命令：
view：检查文件内容或列出目录内容
- 查看整个文件或带有行号的特定行范围 - 使用文件元数据浏览目录列表
str_replace：进行精确的文本替换
- 用新文本替换特定字符串 - 可选择限制更换次数 - 最适合简单、有针对性的替换
edit：按行号编辑代码块
- 用新内容替换整个行范围 - 对于重大代码修改，比str_replace更安全 - 显示更改比较之前/之后
insert：在特定行号处添加新内容
- 在指定行后插入文本 - 添加超出当前文件长度的内容
create：创建新文件或覆盖现有文件
- 创建具有指定内容的文件 - 可选地覆盖现有文件
undo_edit：从备份中还原文件
- 恢复到上次修改前的状态 - 每次编辑都会自动创建备份
安装
先决条件
- Node.js 16或更高版本
- TypeScript
建立
- 创建新项目:
mkdir text-editor-mcp
cd text-editor-mcp
npm init -y- 安装依赖项:
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript- 创建TypeScript配置:
创建一个 tsconfig.json 文件：
{
"compilerOptions": {
"target": "ES2022",
"module": "Node16",
"moduleResolution": "Node16",
"outDir": "./build",
"esModuleInterop": true,
"strict": true
},
"include": ["*.ts"]
}- 保存源代码:
将文本编辑器服务器代码另存为 text-editor-server.ts 在你的项目中。
- 编译:
npx tsc用法
运行服务器
node build/text-editor-server.js /path/to/working/directory如果不指定目录，则默认为 ./texteditor-data.
与Claude for Desktop集成
- 打开Claude for Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 将服务器添加到您的配置中：
{
"mcpServers": {
"text-editor": {
"command": "node",
"args": ["/absolute/path/to/build/text-editor-server.js", "/absolute/path/to/working/directory"]
}
}
}- 重新启动桌面版的Claude。
命令参考
查看命令
查看文件内容或目录列表。
参数：
path（必填）：相对于基本目录的文件或目录路径view_range（可选）：指定要查看的行范围的两个整数数组（例如。，[1, 10])
- 行号为1-索引 - 使用 -1 使最后一行读到文件的末尾
Claude中的示例用法： “显示main.py的内容” “显示server.js的第10-20行” “列出项目目录中的文件”
Str_Replace命令
替换文件中的特定文本。最适合简单、有针对性的文本替换。
参数：
path（必填）：相对于基本目录的文件路径old_str（必填）：要替换的文本new_str（必填）：新文本count（可选）：要替换的出现次数（如果未指定，则全部替换）
Claude中的示例用法： “在utils.js中将'function'替换为'method'” “将error_handler.py中第一次出现的'error'替换为'exception'”
编辑命令
编辑文件中的一系列行。这比 str_replace 用于编辑较大的代码块。
参数：
path（必填）：相对于基本目录的文件路径start_line（必填）：要编辑的第一行编号（从1开始）end_line（必填）：要编辑的最后一行（从1开始，或-1表示“到文件末尾”）new_content（必填）：替换指定行范围的新内容
Claude中的示例用法： “编辑server.js中的第10-15行以实现正确的错误处理” “将第25行开始的函数替换为此改进版本”
插入命令
在特定行号处插入文本。
参数：
path（必填）：相对于基本目录的文件路径line_number（必填）：要插入的行号（从1开始）text（必填）：要插入的文本
Claude中的示例用法： “在main.py的第5行后插入一个docstring” “在app.js的第1行添加一个新的导入语句”
创建命令
使用指定内容创建新文件。
参数：
path（必填）：相对于基本目录的文件路径content（必填）：要写入文件的内容overwrite（可选）：如果文件存在，是否覆盖（默认值：false）
Claude中的示例用法： “使用这些设置创建一个名为config.json的新文件” “创建一个打印‘Hello World’的Python脚本”
撤消编辑命令
从备份中还原文件。
参数：
path（必填）：相对于基本目录的文件路径
Claude中的示例用法： “撤消我上次对README.md的编辑” “将更改还原到server.js”
安全功能
服务器包括几个重要的安全措施：
- 路径验证：确保操作保持在指定的基本目录内
- 自动备份：在修改文件之前创建备份
- 错误处理：为失败的操作提供明确的错误消息
- 目录创建：如果基本目录不存在，则自动创建它
对话示例
以下是一些与克劳德尝试的对话示例：
- “你能创建一个新的Python脚本来计算斐波那契数列吗？”
- “我有一个JavaScript文件有一些语法错误。你能检查一下并修复它们吗？”
- “请为我的Python文件中的所有函数添加适当的文档字符串。”
- “我需要重构此代码以使用async/await。你能帮忙吗？”
- “使用以下设置创建配置文件…”
Claude使用规则
这些规则帮助Claude确定何时以及如何使用文本编辑器工具：
For ANY request involving viewing, editing, creating, or modifying files:
1. When you need to view file content:
+ Use the "view" command with the file path
+ For large files, use view_range parameter to see specific sections
2. When you need to edit existing files:
+ First use "view" to see the current content
+ For simple text replacements, use "str_replace" with old_str and new_str
+ For editing blocks of code or multiple lines, use "edit" with start_line, end_line, and new_content
+ For adding new content at a specific location, use "insert" with line_number and text
3. When you need to create new files:
+ Use "create" with path and content parameters
+ If replacing an existing file, set overwrite to true
4. If a user is unhappy with changes:
+ Use "undo_edit" to revert the most recent change to a file
Always confirm you've made the requested changes and summarize what you've done. When possible, show the relevant portions of the file before and after changes.您可以在Claude提示中包含这些规则，以帮助指导模型何时以及如何使用文本编辑器工具。
Claude使用规则
这些规则帮助Claude确定何时以及如何使用文本编辑器工具：
For ANY request involving viewing, editing, creating, or modifying files:
1. When you need to view file content:
+ Use the "view" command with the file path
+ For large files, use view_range parameter to see specific sections
2. When you need to edit existing files:
+ First use "view" to see the current content
+ For simple replacements, use "str_replace" with old_str and new_str
+ For adding new content at a specific location, use "insert" with line_number and text
3. When you need to create new files:
+ Use "create" with path and content parameters
+ If replacing an existing file, set overwrite to true
4. If a user is unhappy with changes:
+ Use "undo_edit" to revert the most recent change to a file
Always confirm you've made the requested changes and summarize what you've done. When possible, show the relevant portions of the file before and after changes.您可以在Claude提示中包含这些规则，以帮助指导模型何时以及如何使用文本编辑器工具。
故障排除
如果您遇到问题：
- 检查服务器日志
- 验证路径是否正确
- 确保工作目录可写
- 检查Claude for Desktop配置是否正确
- 配置更改后重新启动Claude for Desktop
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交拉取请求。