Filesystem Operations MCP

🚀 バルクファイルシステム操作MCPサーバー

このプロジェクトはFastMCPサーバーを提供しています。このサーバーは、バルクファイルおよびフォルダ操作を実行するためのツールを提供し、集中型例外処理機能も備えています。

✨ 主な機能

🔍 利用可能なツール

このサーバーが提供するツールは、その機能に基づいて以下のカテゴリに分類されます。

• call_tool_bulk：このMCPサーバーに登録された単一のツールを1回のリクエストで複数回呼び出します。これは、もともと複数回の個別のツール呼び出しが必要な操作を高速化するのに非常に有効です。
• call_tools_bulk：このMCPサーバーに登録された複数のツールを1回のリクエストで呼び出します。各呼び出しは異なるツールで、異なるパラメータを含むことができます。これも、もともと複数回の個別の呼び出しが必要な操作を高速化するのに役立ちます。

バルクツールをあなたのFastMCPサーバーに追加するには、https://github.com/jlowin/fastmcp/pull/215 を参照してください。

📄 ファイル操作ツール (file サーバー)

これらのツールは file サーバー名前空間で利用可能です。

• read：指定されたパスのファイルの内容を読み取ります。
• create：指定された内容を含むファイルを作成します。
• append：既存のファイルに内容を追加します。
• erase：ファイルの内容を空にします。
• move：ファイルをソース位置からターゲット位置に移動します。
• delete：指定されたパスのファイルを削除します。

📁 フォルダ操作ツール (folder サーバー)

これらのツールは folder サーバー名前空間で利用可能です。

• create：指定されたパスにフォルダを作成します。
• read_all：フォルダ内のすべてのファイルの内容を返します（再帰的に取得することも可能）。これはリソースを大量に消費する場合があります！
• list：フォルダの内容をリスト表示します（再帰的にリスト表示することも可能）。
• move：フォルダをソース位置からターゲット位置に移動します。
• delete：指定されたパスのフォルダを削除します。
• empty：すべての内容を削除することでフォルダを空にします。

❌ ツールの無効化

特定のファイルツールを無効にするには、DISABLE_FILE_TOOLS を無効にするツール名の配列に設定します。たとえば、file_read ツールを無効にするには、DISABLE_FILE_TOOLS=["file_read"] と設定します。

特定のフォルダツールを無効にするには、DISABLE_FOLDER_TOOLS を無効にするフォルダツール名の配列に設定します。たとえば、folder_create ツールを無効にするには、DISABLE_FOLDER_TOOLS=["folder_create"] と設定します。

バルクツールは現在無効化できません。

🚀 クイックスタート

💻 VS Code McpServerの使用方法

1. コマンドパレット（Ctrl+Shift+PまたはCmd+Shift+P）を開きます。
2. "Settings" と入力し、"Preferences: Open User Settings" を選択します。
3. ユーザー設定に以下の内容を追加します。

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

💻 Roo Code/ClineでのMcpServerの使用方法

1. プロジェクトのルートディレクトリに mcpserver.json ファイルを作成します。
2. ファイルに以下の内容を追加します。

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

💻 開発方法

リポジトリをクローンするには、以下のコマンドを実行します。

git clone https://github.com/your-username/repository.git
cd repository
pip install -r requirements.txt
python app.py

🔄 リポジトリをクローンする代替方法

git+https プロトコルを使用して、直接リポジトリからコードを取得することができます。例えば：

pip install -e git+https://github.com/your-username/repository.git#egg=package-name

この方法で、ブランチ名を指定することで、リポジトリの異なるバージョンをクローンすることができます。例えば：

pip install -e git+https://github.com/your-username/repository.git@branch-name#egg=package-name