Microsoft Edit MCP

🚀 Edit-MCP: Microsoft Edit用のモデルコンテキストプロトコルサーバ

Edit-MCPは、MicrosoftのEditツールと統合されたモデルコンテキストプロトコル（MCP）サーバです。これにより、AIシステムに高度なファイル編集機能を提供します。パフォーマンスのための直接的なファイルシステム操作と、複雑な編集タスクのためのMicrosoft Editとの統合を組み合わせたハイブリッドアーキテクチャを採用しています。

🚀 クイックスタート

Edit-MCPサーバは、AIシステムとファイル編集操作の間の高度なコーディネーターとして機能します。標準化されたMCPインターフェースを公開し、AIモデルが以下の操作を行えるようにします。

• ファイルの読み書き
• テキストの検索と置換
• コードの整形
• 複雑な編集操作
• 複数ファイルの編集の調整
• その他...

✨ 主な機能

Edit-MCPは以下のコンポーネントを持つハイブリッドアーキテクチャを採用しています。

1. コアMCPサーバ

• MCPプロトコル通信を処理します。
• 操作を適切なサブシステムにルーティングします。
• ファイルの状態とメタデータを管理します。
• 複数のEditインスタンス間の調整を行います。
• キャッシュと最適化を提供します。

2. ファイルシステムマネージャ

• 単純なタスクのための直接的なファイル操作を実行します。
• 基本的なCRUD操作を処理します。
• テキスト検索と単純な検索置換を提供します。
• ファイルメタデータ操作を管理します。
• 複数ファイルにまたがるバッチ操作をサポートします。

3. Editインスタンスマネージャ

• 複雑な操作のためのMicrosoft Editプロセスを管理します。
• 複雑な編集シナリオを処理します。
• 複数ファイルの操作を調整します。
• EditのTUIインタラクションをプログラムで管理します。

4. 操作ルーター

• 各操作をどのサブシステムが処理するかを決定します。
• 単純な操作をファイルシステムマネージャにルーティングします。
• 複雑な操作をEditインスタンスマネージャにルーティングします。
• 両サブシステム間のハイブリッド操作を調整します。

📦 インストール

前提条件

• Node.js 16以上
• Microsoft Editがインストールされ、PATHに含まれていること

ソースからインストール

# リポジトリをクローンする
git clone https://github.com/mixelpixx/edit-mcp.git
cd edit-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

サーバの起動

Edit-MCPサーバは、stdioまたはHTTPトランスポートを使用して起動できます。

# stdioトランスポートで起動する（AIシステムとの直接統合用）
npm run stdio

# HTTPトランスポートで起動する（Webベースの統合用）
npm run http

コマンドラインオプション

Usage: edit-mcp [options]

Options:
  -V, --version                バージョン番号を出力する
  -p, --port <port>            HTTPトランスポートでリッスンするポート（デフォルト: "3000"）
  -e, --edit-path <path>       Edit実行ファイルへのパス
  -m, --max-instances <number> Editインスタンスの最大数（デフォルト: "5"）
  -t, --timeout <milliseconds> Editインスタンスのタイムアウト時間（ミリ秒）（デフォルト: "300000"）
  -c, --config <path>          設定ファイルへのパス
  -d, --debug                  デバッグログを有効にする
  -s, --stdio                  HTTPの代わりにstdioトランスポートを使用する
  -h, --help                   コマンドのヘルプを表示する

設定

Edit-MCPはJSON設定ファイルを使用して設定できます。

{
  "editExecutable": "/path/to/edit",
  "maxEditInstances": 5,
  "instanceTimeout": 300000,
  "simpleOperationThreshold": 1000,
  "complexityFactors": {
    "fileSize": 0.3,
    "operationType": 0.4,
    "contextRequirement": 0.3
  }
}

利用可能なツール

Edit-MCPは以下のツールを提供します。

ファイルシステムツール

• read_file: ファイルの内容を読み取ります。
• write_file: ファイルに内容を書き込みます。
• list_files: ディレクトリ内のファイルを一覧表示します。
• find_in_file: ファイル内のパターンの出現箇所を検索します。

Editツール

• format_code: ファイル内のコードを整形します。
• complex_find_replace: 高度な検索と置換操作を実行します。
• interactive_edit_session: 対話型の編集セッションを開始します。

ハイブリッドツール

• smart_refactor: 複数のファイルにまたがるコードをインテリジェントにリファクタリングします。
• backup_and_edit: ファイルを編集する前にバックアップを作成します。

HTTPトランスポート

Edit-MCPは、stdioに加えてHTTPトランスポートもサポートしており、リモートアクセスとREST APIエンドポイントを可能にします。

HTTPトランスポートでの起動

# デフォルトのHTTPポート（3000）で起動する
edit-mcp

# カスタムポートで起動する
edit-mcp --port 8080

# 設定ファイルで起動する
edit-mcp --config config.http.example.json

REST APIエンドポイント

ヘルスチェック

GET /health

JSON-RPCエンドポイント

POST /jsonrpc
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "read_file",
    "arguments": {
      "path": "example.txt"
    }
  },
  "id": 1
}

REST APIエンドポイント

• GET /api/tools - 利用可能なツールを一覧表示します。
• POST /api/tools/:toolName - 特定のツールを呼び出します。
• GET /api/files/:path - ファイルの内容を読み取ります。
• PUT /api/files/:path - ファイルに内容を書き込みます。
• GET /api/list/:directory - ディレクトリ内のファイルを一覧表示します。
• POST /api/search - ファイル内のパターンを検索します。
• POST /api/format - コードを整形します。
• POST /api/refactor - 複数のファイルにまたがるシンボルをリファクタリングします。
• GET /api/docs - APIドキュメントを表示します。

認証

設定ファイルでauthEnabled: trueを設定することで、APIキー認証を有効にできます。

{
  "authEnabled": true,
  "apiKey": "your-secure-api-key"
}

リクエストにAPIキーを含めるには、以下の方法があります。

• ヘッダー: X-API-Key: your-secure-api-key
• クエリパラメータ: ?apiKey=your-secure-api-key

CORS設定

設定ファイルで許可するオリジンを設定できます。

{
  "corsOrigins": ["http://localhost:*", "https://yourdomain.com"]
}

レート制限

設定ファイルでレート制限を設定し、悪用を防止できます。

{
  "rateLimitWindowMs": 900000,  // 15分
  "rateLimitMax": 100           // ウィンドウごとに100リクエスト
}

🔧 開発

プロジェクトのビルド

# プロジェクトをビルドする
npm run build

# 変更を監視して再ビルドする
npm run watch

開発モードでの実行

# ホットリロードで実行する
npm run dev

📄 ライセンス

MIT

謝辞

• Editツールを提供しているMicrosoft
• モデルコンテキストプロトコルコミュニティ