mcp-server-text-editor

local-only server

The server can only run on the client’s local machine because it depends on local resources.

クロードテキストエディターMCPサーバー

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

特徴

  • Claudeのテキストエディタと同一のAPI : Claudeの組み込みテキストエディタツールと全く同じインターフェースを実装します
  • MCPサーバーの実装: AIツール統合のためのモデルコンテキストプロトコル標準に準拠
  • ファイル操作:
    • オプションの行範囲指定でファイルの内容を表示する
    • 新しいファイルを作成する
    • 既存のファイル内のテキストを置き換える
    • 特定の行番号にテキストを挿入する
    • 以前の編集を元に戻す

サポートされているClaudeテキストエディターのバージョン

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

  • text_editor_20241022 (クロード 3.5 ソネット)
  • text_editor_20250124 (クロード 3.7 ソネット)

ただし、組み込みの 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ディレクトリに生成されます。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します!お気軽にプルリクエストを送信してください。

  1. リポジトリをフォークする
  2. 機能ブランチを作成します( git checkout -b feature/amazing-feature
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く
-
security - not tested
A
license - permissive license
-
quality - not tested

Claude 組み込みテキスト エディター ツール バージョンのオープン ソース実装:

text_editor_20241022 (クロード 3.5 ソネット) text_editor_20250124 (クロード 3.7 ソネット)

  1. Features
    1. Supported Claude Text Editor Versions
      1. Installation
        1. Usage
          1. Starting the Server
          2. Configuring in Claude Desktop
          3. Tool Commands
        2. Development
          1. Prerequisites
          2. Setup
          3. Scripts
          4. Testing
        3. License
          1. Contributing
            ID: gl1ytjlxeg