Claude Text Editor

🚀 Claude Text Editor

Claude Text Editorは、Model Context Protocol (MCP) を通じてClaude Desktopと統合された、シームレスなテキスト編集システムです。MacOS上のどこでもテキストを選択し、Claudeに編集を依頼すると、自動的に編集後のバージョンを受け取ることができます。

✨ 主な機能

• 🚀 摩擦のない編集：テキストを選択 → 右クリック → "Edit with Claude" → 編集済みテキストを取得
• 📁 ファイルベースの処理：タイムアウトがなく、フォーカスの切り替えも必要ありません
• 🔄 自動キュー管理：インボックスにファイルをドロップすると、アウトボックスで結果を取得できます
• 🎯 カスタマイズ可能なプロンプト：claude_prompt.txt で編集指示を定義できます
• 🖥️ システム全体での統合：すべてのMacOSアプリケーションで動作します
• 🔔 デスクトップ通知：テキスト処理が完了したら通知を受け取ります
• 📋 自動クリップボード：編集済みテキストは自動的にクリップボードにコピーされます
• 🤖 MCP搭載：Claude Desktopとネイティブに統合されています

前提条件

• macOS (macOS 14.xでテスト済み)
• Claude Desktopアプリがインストールされている
• ターミナルへのアクセス
• インターネット接続
• Homebrew (デスクトップ通知にはオプションですが推奨)
  • インストール先: https://brew.sh
  • または実行: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

📦 インストール

クイックインストール (推奨)

# リポジトリをクローン
git clone https://github.com/lucapinello/claude-text-editor.git
cd claude-text-editor

# インストールスクリプトを実行
./install.sh

インストールスクリプトは以下を行います：

• Python/conda/mambaのチェック
• 必要なディレクトリの作成
• environment.yml からPython環境のセットアップ
• 依存関係のインストール (MCPを含む)
• デスクトップ通知用の terminal-notifier のインストール (Homebrewがインストールされている場合)
• Claude Desktopの設定
• すべてのファイルを正しい場所にコピー
• デフォルトのプロンプトファイルの作成

注意：デスクトップ通知にはHomebrewが必要です。インストールされていない場合でも、テキスト処理が完了すると音声フィードバック (Glass音) が鳴ります。

クイックスタート

インストール後、Claude DesktopでClaude Text Editorを初期化する必要があります：

Claude Text Editorの初期化 (簡単な方法)

1. インストール後に Claude Desktopを再起動 します
2. claude_text_editor という名前の 新しいチャットを作成 します
3. このメッセージを コピーして貼り付け 、Enterキーを押します：

I'm using the Claude Text Editor MCP server.

CONTINUOUS TEXT EDITOR MONITORING TASK

CORE DIRECTIVE: Monitor and process text files indefinitely without stopping.

OPERATIONAL RULES:
- Run FOREVER until explicitly told to stop
- Work silently - NO status updates, NO explanations
- Only output when actually processing a file (minimal output only)

INFINITE LOOP PROCESS:
- check_edit_queue
- If files exist → get_text_to_edit → edit → save_edited_text
- wait_for_files (30 seconds)
- Return to step 1

OUTPUT MINIMIZATION:
- Process files without commentary
- No logging except essential file processing confirmations
- Maintain silent operation to conserve resources

4. Claudeがツールが利用可能であることを確認し、ファイルの監視を開始します
5. テキストエディタを使用している間は このチャットを開いたまま にしておきます - Claudeはファイルが届くと自動的に処理します

セットアップのテスト

# 簡単なファイルでテスト
echo "This is a test sentance with bad grammer." > ~/.claude_text_editor/inbox/test.txt

# チャットが監視している場合、Claudeは自動的に処理します
# 結果を確認
cat ~/.claude_text_editor/outbox/test.txt

💻 使用例

基本的な使用法

1. claude_text_editor チャットをアクティブにした状態で Claude Desktopを開いたまま にします
2. キーボードショートカット (⌥⌘.) を使用します：
   • テキストを選択した状態で：選択したテキストを処理します
   • 選択していない状態で：クリップボードの内容を処理します
3. Claudeが自動的に処理し、結果を ~/.claude_text_editor/outbox/ に保存します
4. 即座にフィードバックを受け取ります：
   • デスクトップ通知が表示されます (Homebrew + terminal-notifierが必要)
   • "Glass" 音が鳴ります (常に動作します)
   • テキストが自動的にクリップボードにコピーされます

クライアントスクリプトの使用

# クリップボードからテキストを編集
pbpaste | ~/claude-text-editor/claude_text_client.py

# ファイルからテキストを編集
cat myfile.txt | ~/claude-text-editor/claude_text_client.py

# カスタムタイムアウトで編集
echo "Edit this text" | ~/claude-text-editor/claude_text_client.py --timeout 60

# クリップボードにコピーせずに編集
echo "Edit this text" | ~/claude-text-editor/claude_text_client.py --no-clipboard

クイックコマンドライン関数

即座にテキストを編集するために、これを ~/.zshrc または ~/.bashrc に追加します：

ce() {
    if [ $# -eq 0 ]; then
        # 引数がない場合: クリップボードを使用
        pbpaste | ~/claude-text-editor/claude_text_client.py
    else
        # 引数がある場合: 引数をクライアントにパイプで渡す
        printf '%s\n' "$*" | ~/claude-text-editor/claude_text_client.py
    fi
}

これでどこからでもすぐにテキストを編集できます：

# クリップボードの内容を編集
ce

# 直接入力したテキストを編集
ce Fix this sentence that have bad grammer

どちらの方法も、通知とクリップボード統合を備えた完全なクライアントワークフローを使用します！

編集指示のカスタマイズ

Claudeがテキストを処理する方法を変更するには、~/.claude_text_editor/claude_prompt.txt を編集します：

Please edit the following text to:
- Make it more formal and professional
- Fix any technical inaccuracies
- Add relevant examples where appropriate

Text to edit:

システム全体でのテキスト編集ショートカット

インストールスクリプトは必要なファイルを設定します。キーボードショートカットを有効にするには：

オプション1: 事前作成されたショートカットをインポート (最も簡単)

1. Shortcuts アプリを開きます
2. File → Import またはプロジェクトフォルダから Edit_with_Claude.shortcut をドラッグします
3. ショートカットはすでに設定されており、すぐに使用できます！

オプション2: 手動でショートカットを作成

1. Shortcuts アプリを開きます
2. + をクリックして新しいショートカットを作成します
3. これらのアクションを追加します：
   • Receive Text: "Quick Actions" から
   • Run Shell Script:
     • Shell: /bin/bash
     • Pass Input: "to stdin"
     • Script: ~/claude-text-editor/claude_text_shortcut.sh
4. 設定 (⚙️):
   • ✅ Use as Quick Action
   • ✅ Services Menu
   • Name: "Edit with Claude"

キーボードショートカットの追加

1. システム設定 → キーボード → キーボードショートカット → サービス
2. "Text" の下にある "Edit with Claude" を見つけます
3. ショートカットを追加: ⌥⌘. (Option+Command+Period)

これで以下が可能になります：

• テキストを選択 → ⌥⌘. → Claudeが処理 → 結果がクリップボードにコピーされます！
• 選択していない状態 → ⌥⌘. → Claudeがクリップボードの内容を処理 → 結果がクリップボードにコピーされます！

🔧 技術詳細

システムはいくつかのコンポーネントで構成されています：

• MCPサーバー (text-editor-server.py)：Claude Desktopと統合されています
• ファイルモニター：~/.claude_text_editor/inbox/ の新しいファイルを監視します
• クライアントスクリプト (claude_text_client.py)：テキスト編集のコマンドラインインターフェースです
• ラッパースクリプト (mcp-server-wrapper.sh)：Python環境を管理します

ファイルの流れ

ユーザー入力 → inbox/ → Claudeが処理 → outbox/ → ユーザーが出力を受け取る

トラブルシューティング

サーバーが接続できない

1. ログを確認します: tail -100 ~/Library/Logs/Claude/mcp-server-text-editor.log
2. conda環境を確認します: conda activate claude-text-editor && which python
3. サーバーを直接テストします: ~/claude-text-editor/mcp-server-wrapper.sh

Claude Desktopでツールが利用できない

1. 設定後にClaude Desktopが再起動されたことを確認します
2. 設定ファイルのパスがユーザー名に合っていることを確認します
3. ラッパースクリプトが実行可能であることを確認します
4. ログにエラーメッセージがないか確認します

パーミッションエラー

chmod +x ~/claude-text-editor/mcp-server-wrapper.sh
chmod +x ~/claude-text-editor/claude_text_client.py

Pythonまたはモジュールが見つからない

1. condaがシェルで適切に初期化されていることを確認します
2. 環境がアクティブ化されていることを確認します: conda activate claude-text-editor
3. MCPがインストールされていることを確認します: pip list | grep mcp

アンインストール

システムからClaude Text Editorを完全に削除するには：

./uninstall.sh

アンインストールスクリプトは以下を行います：

• インストールディレクトリを削除します
• conda環境を削除します (使用している場合)
• Claude Desktopの設定をクリーンアップします
• オプションでデータディレクトリを削除します
• ショートカットの手動クリーンアップの指示を提供します

開発

プロジェクト構造

~/claude-text-editor/
├── text-editor-server.py           # MCPサーバーの実装
├── mcp-server-wrapper.sh           # 環境ラッパー
├── claude_text_client.py           # コマンドラインクライアント
└── ~/.claude_text_editor/
    ├── inbox/                      # テキストファイルをここにドロップ
    ├── outbox/                     # 編集済みファイルをここで受け取る
    └── claude_prompt.txt           # 編集指示

システムの拡張

以下の方法でシステムを拡張できます：

1. MCPサーバーに新しいツールを追加する
2. 特定のワークフロー用の追加のクライアントスクリプトを作成する
3. AppleScriptまたはシェルスクリプトを介して他のアプリケーションと統合する

コントリビューション

コントリビューションは大歓迎です！以下の手順を踏んでください：

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください

謝辞

• Model Context Protocol (MCP) を使用して構築されています
• Claude Desktop を動力源としています
• Miniforge によるPython環境管理