File Control MCP

🚀 拡張ディレクトリコンテキストMCPサーバー

ClaudeのようなAIアシスタントに高度なディレクトリ分析とファイル管理機能を提供する包括的なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、ディレクトリコンテキストの抽出と完全なファイル編集機能を組み合わせ、コード分析、プロジェクト管理、およびファイル操作に強力なツールとなります。

🚀 クイックスタート

クイックセットアップ

1. 依存関係をインストールします: npm install
2. Claude Desktopの設定に追加します:

{
  "mcpServers": {
    "directory-context": {
      "command": "node",
      "args": ["path/to/server.js"]
    }
  }
}

✨ 主な機能

🔍 ディレクトリ分析

• 完全なディレクトリ構造: 任意のディレクトリの詳細なツリービューとメタデータを取得します。
• インテリジェントなプロジェクト分析: 自動的にプロジェクトタイプを検出し、コンテキストの要約を提供します。
• スマートなファイル検索: 複数のファイルタイプに対して正規表現とテキストベースの検索をサポートします。
• Git統合: リポジトリのコンテキスト、コミット履歴、作業ディレクトリの状態を抽出します。
• ファイル統計: ファイルタイプ、サイズ、および変更日の包括的な分析を行います。

📝 ファイル操作

• ファイルの作成: 指定された内容で新しいファイルを生成します。
• ファイルの更新: 正規表現をサポートする高度な検索と置換操作を行います。
• 内容の追加: 書式オプションを持つ既存のファイルに内容を追加します。
• ファイルの削除: オプションでバックアップを作成してファイルを削除します。
• ファイルの名前変更/移動: 衝突検出を行いながらファイルを移動および名前変更します。
• ディレクトリの管理: 再帰的にディレクトリ構造を作成します。

🔄 高度な機能

• バッチ操作: 単一のトランザクションで複数のファイル操作を実行します。
• 自動バックアップ: 破壊的な操作に対して自動的にバックアップを作成します。
• トランザクションのロールバック: エラーが発生した場合、バッチ操作を完全にロールバックできます。
• リソースの公開: 重要なプロジェクトファイルを自動的にMCPリソースとして公開します。
• エラーハンドリング: デバッグ用の詳細なエラー報告を行います。

📦 インストール

前提条件

• Node.js 18.0.0以上
• npmまたはyarnパッケージマネージャー

セットアップ

1. MCPサーバーのファイルをクローンまたはダウンロードします。
2. 依存関係をインストールします:

npm install

3. MCPクライアント（Claude Desktopなど）をこのサーバーを使用するように設定します。

Claude Desktopの設定: claude_desktop_config.jsonに以下を追加します:

{
  "mcpServers": {
    "directory-context": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "cwd": "your-default-working-directory"
    }
  }
}

代替設定: 提供されているmcp-json-config.jsonをテンプレートとして使用し、パスを適宜更新します。

💻 使用例

作業ディレクトリの設定

機能を使用する前に、作業ディレクトリを設定します:

set_working_directory(directory="/path/to/your/project")

ディレクトリ分析ツール

ディレクトリ構造の取得

get_directory_structure(
  max_depth=10,           // 最大トラバーサル深度
  include_hidden=false,   // 隠しファイル/ディレクトリを含める
  file_types=[".js", ".py", ".md"]  // 拡張子でフィルタリング
)

プロジェクトコンテキストの分析

analyze_project_context(
  include_code_analysis=true,    // 複雑度分析を含める
  focus_files=["specific_file.js"]  // 特定のファイルに焦点を当てる
)

ファイルの検索

search_files(
  query="function myFunction",  // 検索クエリ
  file_types=[".js", ".ts"],   // 検索するファイルタイプ
  is_regex=false,              // 正規表現を使用する
  max_results=50               // 最大結果数
)

Gitコンテキストの取得

get_git_context(
  include_diff=true,     // 作業ディレクトリの変更を含める
  commit_count=10        // 最近のコミット数
)

ファイル管理ツール

ファイルの作成

create_file(
  path="src/new-component.js",
  content="const MyComponent = () => { ... }",
  encoding="utf8",
  overwrite=false
)

ファイルの更新

update_file(
  path="src/config.js",
  updates=[
    {
      search: "oldValue: 'old'",
      replace: "newValue: 'new'",
      regex: false,
      all: true
    }
  ],
  backup=true
)

ファイルへの内容の追加

append_to_file(
  path="README.md",
  content="## New Section\nContent here...",
  newline_before=true
)

ファイルの削除

delete_file(
  path="old-file.js",
  backup=true  // .deletedバックアップを作成する
)

ファイルの名前変更/移動

rename_file(
  old_path="old-name.js",
  new_path="new-name.js",
  overwrite=false
)

ディレクトリの作成

create_directory(
  path="src/components/new-feature",
  recursive=true
)

バッチ操作

複数の操作をアトミックに実行します:

batch_file_operations(
  operations=[
    {
      operation: "create",
      params: {
        path: "src/component.js",
        content: "export default () => {}"
      }
    },
    {
      operation: "update",
      params: {
        path: "src/index.js",
        updates: [...]
      }
    }
  ],
  rollback_on_error=true
)

📚 詳細ドキュメント

プロジェクトタイプの検出

サーバーは、設定ファイルに基づいて自動的にプロジェクトタイプを検出します:

• Node.js/JavaScript: package.json
• Python: requirements.txt
• Rust: Cargo.toml
• Go: go.mod
• Java: pom.xml, build.gradle
• PHP: composer.json
• Ruby: Gemfile
• Docker: Dockerfile, docker-compose.yml
• その他...

ファイル優先度の検出

サーバーは自動的に重要なファイルを識別します:

• 設定ファイル (package.json, config.jsなど)
• エントリポイント (index.js, main.py, app.js)
• ドキュメント (README.md, docs)
• Dockerファイル
• 環境ファイル (.env)

リソースの公開

重要なファイルは自動的にMCPリソースとして公開され、AIアシスタントが明示的なファイル読み取り要求なしで簡単にアクセスできるようになります。

エラーハンドリングと安全機能

• バックアップの作成: 破壊的な操作に対して自動的にバックアップを作成します。
• 衝突検出: 誤った上書きを防止します。
• トランザクションのロールバック: エラーが発生した場合、バッチ操作を完全にロールバックできます。
• パスの検証: 操作が作業ディレクトリの範囲内に留まることを保証します。
• 詳細なエラーメッセージ: デバッグ用の詳細なエラー報告を行います。

🔧 技術詳細

メインツール

APIリファレンス

コアツール

ファイル操作

設定オプション

サーバー設定

• 作業ディレクトリ: set_working_directoryまたは初期化時に設定します。
• ファイルタイプフィルター: 設定可能なファイル拡張子フィルタリング。
• 検索制限: 設定可能な最大検索結果数。
• バックアップポリシー: 破壊的な操作に対するオプションのバックアップ作成。

MCPクライアント設定

適切なコマンドと引数でMCPクライアントでサーバーを設定します。サーバーは標準入出力を介して通信し、追加のネットワーク設定は必要ありません。

🚧 開発と貢献

プロジェクト構造

enhanced-directory-context-mcp/
├── server.js                 # メインのMCPサーバーの実装
├── package.json             # Node.jsパッケージの設定
├── mcp-json-config.json     # 例のMCPクライアント設定
└── README.md               # このドキュメント

依存関係

• @modelcontextprotocol/sdk: コアのMCP機能
• Node.jsの組み込みモジュール: fs, path, child_process

開発モードでの実行

npm run dev

これにより、デバッグ用にNode.jsインスペクターが有効になった状態でサーバーが起動します。

📄 ライセンス

MITライセンス - 詳細はpackage.jsonを参照してください。

サポートと問題報告

問題、機能要求、または貢献については、リポジトリの問題トラッカーを参照してください。

⚠️ 重要提示

このMCPサーバーは強力なファイルシステムアクセスを提供します。AIアシスタントを信頼し、実行される操作、特にファイルの削除や変更などの破壊的な操作を理解してください。