JinDaGe - Text Saver MCP Details

article

README

🚀 文本保存器 MCP

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

依赖项

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

设置

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

pip install -r requirements.txt

配置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开发者控制台中的日志。

Text Saver