TextSaver

Saves Claude-provided text to files with safe naming, timestamps, and directory restrictions.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "technavii-mcp_sample": {
      "command": "/full/path/to/python",
      "args": [
        "/full/path/to/text_saver_mcp.py"
      ]
    }
  }
}

TextSaver MCP is a Claude-aware server you run locally to save text passed from Claude into files on your computer. It includes protections like filename validation, sanitization, and size limits, plus automatic timestamping when you don’t specify a filename. This makes saving notes, ideas, or code snippets quick and safe from common filesystem abuse.

How to use

Use natural language prompts to have Claude save your text to a file. For example, you can say Save this text to a file, Save this information to a file called notes.txt, or Write this content to a text file named project-ideas.txt. The server writes the content to the designated directory with a safe filename, creating a timestamped name automatically if you don’t provide one.

How to install

Prerequisites you need before installing are Python 3.8 or higher and the Claude Desktop application.

Install dependencies using pip from a shell.

pip install -r requirements.txt

Additional configuration and usage notes

Configure Claude Desktop to connect to the MCP server by specifying the Python interpreter and the path to the server script, plus the working directory and network details. The server runs locally, so you point Claude to 127.0.0.1 on port 8080.

Security and reliability

The server includes size limits (default 10 MB) to prevent saving excessively large files. Filenames undergo validation and sanitization to remove unsafe characters and to block directory traversal attempts. Paths are constrained so files can only be saved within the specified directory.

Troubleshooting

If Claude cannot start the server due to a missing Python executable, provide the full path to the Python interpreter in the configuration. If you encounter a read-only filesystem error, ensure the destination directory is writable and correctly configured. Check permissions on the save directory and adjust as needed (for example, chmod 755 /path/to/save/directory). Detailed logs help pinpoint issues in the client console.

Available tools

save_text_to_file

Saves incoming text to a file with a user-specified name or a timestamped default when no name is provided.

generate_timestamp_filename

Creates a timestamped filename when the user does not supply a filename.

validate_filename

Checks that the provided filename is safe and does not contain disallowed characters or paths.

sanitize_filename

Cleans up unsafe filename characters to prevent issues on different filesystems.

protect_directory_traversal

Prevents attempts to access directories outside the designated save path.

handle_errors_and_logging

Logs operations and handles errors gracefully to aid debugging.

enforce_size_limits

Enforces the maximum allowed size for saved content to prevent abuse.