TextSaver MCP

TextSaver MCP

site icon
2025.03.16 0
Python文本保存文件管理内容生成
TextSaver MCP 是一个基于 Claude 的 MCP(Model Context Protocol)服务器,允许用户将文本保存到本地文件系统中。该服务提供了简单易用的命令接口,支持自动生成带时间戳的文件名,并具备多重安全保护机制,如文件名验证、目录遍历攻击防护等。
View on GitHub

Overview

基本能力

产品定位

TextSaver MCP 是一个用于将文本内容保存到本地文件的工具,特别适用于需要频繁保存文本信息的场景。

核心功能

  • 📝 通过简单命令将文本输入保存到文件
  • 🕒 自动生成带时间戳的文件名(如未提供文件名)
  • 🔒 内置安全性功能,包括文件名验证和清理
  • 🚫 防止目录遍历攻击
  • ⚠️ 全面的错误处理和日志记录
  • ✅ 文件大小限制,防止滥用文件系统

适用场景

  • 需要将对话或笔记保存为本地文件的场景
  • 自动化保存生成的内容(如代码片段、项目想法等)
  • 需要安全地保存敏感文本信息的场景

工具列表

  • text_saver_mcp.py:主服务脚本,提供文本保存功能

常见问题解答

  1. "spawn python ENOENT"错误:Claude找不到Python可执行文件,需在配置文件中使用Python的完整路径
  2. "Read-only file system"错误:脚本没有权限写入指定目录,需确保目录可写
  3. 权限问题:确保保存目录有适当的写入权限

使用教程

使用依赖

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

安装教程

  1. 克隆仓库
  2. 安装依赖: pip install -r requirements.txt
  3. 配置Claude Desktop使用MCP服务器:
  4. 打开配置文件:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
  5. 添加配置(替换为实际路径): 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 } } }
  6. 重启Claude Desktop

调试方式

  1. 检查Claude Desktop开发者控制台中的日志
  2. 确保Python路径正确
  3. 验证保存目录权限: bash chmod 755 /path/to/save/directory

许可证

None