Text Saver

🚀 文本保存器 MCP

文本保存器 MCP 是一个 Claude MCP（模型上下文协议）服务器，它能让 Claude 将文本保存到您本地文件系统的文件中，为文本保存提供了便捷的解决方案。

🚀 快速开始

文本保存器 MCP 允许您借助 Claude，轻松地将文本保存到本地文件系统。完成安装和配置后，就能使用自然语言指令让 Claude 保存文本。

✨ 主要特性

• 📝 使用简单命令将文本输入保存到文件，操作便捷。
• 🕒 若未提供文件名，会自动生成带时间戳的文件名。
• 🔒 内置安全功能，涵盖文件名验证和清理。
• 🚫 具备防止目录遍历攻击的保护机制。
• ⚠️ 拥有全面的错误处理和日志记录功能。
• ✅ 设有文件大小限制，可防止文件系统被滥用。

📦 安装指南

依赖项

• Python 3.8 或更高版本
• Claude Desktop 应用程序

设置

1. 克隆此仓库。
2. 安装所需的依赖项：

pip install -r requirements.txt

3. 配置Claude Desktop以使用MCP服务器： 打开您的Claude Desktop配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json

添加以下配置：

{
"mcpServers": {
"text-saver": {
"command": "/full/path/to/python",
"args": [
"/full/path/to/text_saver_mcp.py"
],
"cwd": "/path/to/writable/directory",
"host": "127.0.0.1",
"port": 8080,
"timeout": 30000
}
}
}

请确保将路径替换为您系统上的实际位置。 4. 重启Claude Desktop。

💻 使用示例

基础用法

设置完成后，您可以使用自然语言要求Claude保存文本到文件，例如：

• “将此文本保存到文件”
• “将此信息保存到名为notes.txt的文件中”
• “将此内容写入名为project-ideas.txt的文本文件”

文本将保存到配置中指定的目录。

🔧 技术细节

安全功能

• 文件大小限制：防止保存过大的文件（默认：10MB）。
• 文件名验证：确保文件名安全且不包含路径遍历尝试。
• 清理：自动清理不安全的文件名。
• 路径控制：只能在指定目录中保存文件。

📚 详细文档

故障排除

常见问题

• “spawn python ENOENT” 错误：此错误表示Claude无法找到Python可执行文件。请在配置文件中使用Python的实际全路径：

# 查找您的Python路径
which python

# 然后在配置中使用该路径

• “只读文件系统” 错误：这意味着脚本没有权限写入指定目录。请确保设置了一个可写的目录。
• 权限问题：确保保存文件的目录具有适当的写权限：

chmod 755 /path/to/save/directory

调试

该脚本包含详细的日志记录以帮助诊断问题。查看Claude Desktop开发者控制台中的日志。