Claude Text Editor MCP Server

Claude テキストエディター MCP サーバー

Claude 組み込みのテキストエディターツールを、Model Context Protocol（MCP）サーバーとして実装したオープンソースのプロジェクトです。このパッケージは、Claude 組み込みのテキストエディターツールと同じ機能を提供し、標準化された API を通じてテキストファイルの表示、編集、作成を行えます。

特長

• Claude のテキストエディターと同一の API：Claude 組み込みのテキストエディターツールとまったく同じインターフェースを実装しています
• MCP サーバーの実装：AI ツール統合のための Model Context Protocol 標準に準拠しています
• ファイル操作：
  • 行範囲を指定してファイルの内容を表示
  • 新しいファイルを作成
  • 既存ファイル内のテキストを置換
  • 指定した行番号にテキストを挿入
  • 直前の編集を元に戻す

対応する Claude テキストエディターのバージョン

このパッケージは、Claude 組み込みのテキストエディターツールの次のバージョンと同等のツールを実装しています。

• text_editor_20241022（Claude 3.5 Sonnet）
• text_editor_20250124（Claude 3.7 Sonnet）

ただし、Claude 組み込みツールとの名前の競合を避けるため、ツール名には「text_editor」を使用します。

インストール

# Install from npm
npm install mcp-server-text-editor

# Or with pnpm
pnpm add mcp-server-text-editor

使用方法

サーバーの起動

# Using npx
npx -y mcp-server-text-editor

# Or if installed globally
mcp-server-text-editor

Claude Desktop での設定

{
  "mcpServers": {
    "textEditor": {
      "command": "npx",
      "args": ["-y", "mcp-server-text-editor"]
    }
  }
}

ツールのコマンド

表示

ファイルまたはディレクトリの内容を表示します。

{
  "command": "view",
  "path": "/path/to/file.js",
  "view_range": [1, 10] // Optional: Show lines 1-10 only
}

作成

指定した内容で新しいファイルを作成します。

{
  "command": "create",
  "path": "/path/to/file.js",
  "file_text": "console.log('Hello, world!');"
}

文字列の置換

ファイル内のテキストを置換します。

{
  "command": "str_replace",
  "path": "/path/to/file.js",
  "old_str": "console.log('Hello, world!');",
  "new_str": "console.log('Hello, Claude!');"
}

挿入

指定した行にテキストを挿入します。

{
  "command": "insert",
  "path": "/path/to/file.js",
  "insert_line": 5,
  "new_str": "// This line was inserted by Claude"
}

編集を元に戻す

ファイルに対する最後の編集を取り消します。

{
  "command": "undo_edit",
  "path": "/path/to/file.js"
}

開発

前提条件

• Node.js 18+
• pnpm

セットアップ

# Clone the repository
git clone https://github.com/bhouston/mcp-server-text-editor.git
cd mcp-server-text-editor

# Install dependencies
pnpm install

# Build the project
pnpm build

スクリプト

• pnpm build：TypeScript プロジェクトをビルドします
• pnpm lint：自動修正付きで ESLint を実行します
• pnpm format：Prettier でコードをフォーマットします
• pnpm clean：ビルド成果物を削除します
• pnpm clean:all：ビルド成果物と node_modules を削除します
• pnpm test：テストを実行します
• pnpm test:coverage：カバレッジレポート付きでテストを実行します

テスト

このプロジェクトでは、テストに Vitest を使用しています。

テストを実行するには、次のコマンドを実行します。

# Run all tests
pnpm test

# Run tests with coverage report
pnpm test:coverage

テストカバレッジレポートは coverage ディレクトリに生成されます。

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します