Editor MCP

🚀 テキストエディタMCPユーザーガイド

テキストエディタMCPはFastMCPを通じて強力なテキスト編集サーバーを実現しています。これにより、AIアシスタントが構造化された方法でコードやその他のテキストファイルを編集できます。従来のコマンドラインツールと比較して、MCPはファイルの整合性検証、使用制限、対話型確認プロセスなどの高度な機能を提供しています。

📑 目次

• 環境変数
  • 最大選択行数
  • 統計収集の有効化
  • ID検証の無効化
• サーバー実装の詳細
  • 初期化
  • ファイル整合性検証システム
  • 登録されたツール
• システムプロンプトのベストプラクティス
• 使用統計情報
  • データ収集
  • 記録される情報
  • 保存場所
  • プライバシーに関する考慮事項
• トラブルシューティング
  • 一般的な問題
• インスピレーションの源

🛠️ 環境変数

MCPは環境変数を通じて設定をサポートしており、以下はいくつかの重要な環境変数です。

最大選択行数

max_select_lines：overwrite操作で選択できる最大行数を制限します。デフォルトは50です。例えば：

export max_select_lines=100

統計収集の有効化

DUCKDB_USAGE_STATS：有効にすると、MCPは使用統計情報をDuckDBデータベースに収集します。

ID検証の無効化

DISABLE_ID_VERIFICATION：trueに設定すると、ファイル内容の整合性検証を無効にできます。例えば：

export DISABLE_ID_VERIFICATION=true

🔧 サーバー実装の詳細

初期化

メインクラス TextEditorServer は初期化時にFastMCPインスタンスを受け取り、"text-editor"と命名されます。

ファイル整合性検証システム

このシステムはSHA-256を使用して、ファイル内容または選択された行範囲の一意の識別子を生成します。例えば、特定の行の変更操作では、IDに行範囲の接頭辞（例："L10-15-[ハッシュ値]"）が含まれ、編集操作が予期した内容に適用されることを保証します。

登録されたツール

サーバーはFastMCPを通じて以下の主要なツールを登録しています。

• set_file：現在編集するファイルのパスを設定します。
• skim：ファイル全体の内容を読み取り、行番号から行テキストへの辞書を返します。
• read：指定された行範囲の内容を読み取り、構造化された辞書を返します。
• select：後続のoverwrite操作で対象となる特定の行（最大50行）を選択します。
• overwrite：新しい行のリストを受け取り、変更予定を表示するdiff形式のプレビューを生成します。
• confirm：前のoverwriteツールで準備された変更を適用します。
• cancel：overwriteツールで保留中の変更を破棄します。
• delete_file：現在のファイルを削除します。
• new_file：新しいファイルを作成します。
• find_line：特定のテキストを含む行を検索します。
• find_function：PythonおよびJavaScript/JSXファイル内の関数定義を検索します。
• その他のツール...

💡 システムプロンプトのベストプラクティス

AIアシスタントの動作を最適化するために、システムプロンプト（system prompt）の使用をおすすめします。例えば：

mcp_server.set_system_prompt("経験豊富なソフトウェアエンジニアとして、編集操作を厳格かつ安全に実行する必要があります。")

これにより、アシスタントがファイルの変更を行う際により慎重になり、最適なプログラミングプラクティスに従うことができます。

📊 使用統計情報

データ収集

MCPはDuckDBを使用したデータ収集機能を提供しており、ユーザーのサーバー使用状況を記録します。

記録される情報

以下を含みますが、これらに限定されません。

• ユーザーID
• 操作タイプ（読み取り、書き込みなど）
• 操作タイムスタンプ
• ファイルサイズの変化
• エラーログ

保存場所

統計データは現在の作業ディレクトリにある mcp_usage.db データベースファイルに保存されます。

プライバシーに関する考慮事項

収集されたすべてのデータは匿名化されており、サービス品質の改善とシステム性能の分析のみに使用されます。

🚑 トラブルシューティング

一般的な問題

• 問題：MCPサーバーに接続できません。

  • 解決策：サーバーが実行中であることを確認し、ネットワーク設定が正しいことを確認してください。

• 問題：ID検証に失敗するエラーが表示されます。

  • 解決策：ID検証を有効にする（デフォルトで有効）か、この機能を無効にしてください。

💡 インスピレーションの源

このプロジェクトはオープンソースコミュニティ、特にFastMCPや類似ツールの成功事例からインスピレーションを得ています。