mcp_sample

TextSaver MCP

A Claude MCP (Model Context Protocol) server that allows Claude to save text to files on your local filesystem.

Features

• 📝 Save text input to files with a simple command
• 🕒 Automatically generates timestamped filenames if none provided
• 🔒 Built-in security with filename validation and sanitization
• 🚫 Protection against directory traversal attacks
• ⚠️ Comprehensive error handling and logging
• ✅ Size limit protections to prevent filesystem abuse

Installation

Prerequisites

• Python 3.8 or higher
• Claude Desktop application

Setup

1. Clone this repository:

2. Install the required dependencies:

   pip install -r requirements.txt
   

3. Configure Claude Desktop to use the MCP server:

   Open your Claude Desktop configuration file:

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

   Add the following configuration:

   {
     "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
       }
     }
   }
   

   Be sure to replace the paths with the actual locations on your system.

4. Restart Claude Desktop

Usage

Once set up, you can ask Claude to save text to files using natural language:

• "Save this text to a file"
• "Save this information to a file called notes.txt"
• "Write this content to a text file named project-ideas.txt"

The text will be saved to the directory specified in the configuration.

Security Features

• File size limits: Prevents saving excessively large files (default: 10MB)
• Filename validation: Ensures filenames are safe and don't contain path traversal attempts
• Sanitization: Automatically sanitizes unsafe filenames
• Path control: Files can only be saved in the specified directory

Troubleshooting

Common Issues

"spawn python ENOENT" Error

This error means Claude can't find the Python executable. Use the full path to your Python interpreter in the configuration file:

# Find your Python path
which python

# Then use that path in your configuration

"Read-only file system" Error

This means the script doesn't have permission to write to the specified directory. Make sure you've set a writable directory in the script or configuration.

Permission Issues

Ensure the directory where you're saving files has appropriate write permissions:

chmod 755 /path/to/save/directory

Debugging

The script includes detailed logging to help diagnose issues. Check the logs in the Claude Desktop developer console.