Text Saver

🚀 テキスト保存器 MCP

Claude MCP（モデルコンテキストプロトコル）サーバーで、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の開発者コンソールのログを確認してください。