File System MCP Server

🚀 文件系统 MCP サーバ

文件システム MCP サーバは、FastMCP をベースに構築された最新のファイル管理システムです。このシステムは、ファイルのコピー、移動、削除、内容の読み取りや書き込みなど、豊富なファイルおよびディレクトリ操作機能を提供します。また、ファイル情報の取得、ファイルの検索、ディレクトリの作成と削除、ディレクトリ内容の一覧表示などの機能もサポートしています。システム情報セクションでは、コンピュータのハードウェア、ストレージデバイス、ディレクトリの統計情報を提供することができます。

🚀 クイックスタート

このセクションでは、ファイルシステム MCP サーバの基本的なセットアップと使用方法を説明します。

✨ 主な機能

• ファイルのコピー、移動、削除、読み取り、書き込みなどの操作をサポート。
• ファイル情報の取得、ファイルとディレクトリの検索機能。
• ディレクトリの作成、削除、内容の一覧表示。
• システムのハードウェア、ストレージ、ディレクトリの統計情報の取得。

📦 インストール

依存関係のインストール

Python パッケージをインストールするには、以下のコマンドを実行します。

pip install -r requirements.txt

📚 ドキュメント

サポートされるプラットフォーム

Windows

• すべての Windows オペレーティングシステムバージョンをサポート。
• 完全なファイルおよびディレクトリ操作機能を提供。
• ドライブリストの表示とパス処理をサポート。

macOS/Linux

• macOS と Linux システムをサポート。
• 基本的なファイルおよびディレクトリ操作機能を提供。
• 一部のプラットフォーム関連の機能が制限される場合があります。

将来の計画

機能開発ロードマップ

1. 第 1 段階：基本的なクロスプラットフォーム互換性の改善

   • ファイルパス処理ロジックを改善。
   • システム情報検索の安全性と正確性を向上。
   • 既知の問題（ファイル削除失敗、ドライブリスト不備など）を修正。

2. 第 2 段階：拡張機能の開発

   • プラットフォーム間で統一されたエラー処理メカニズムを実装。
   • より多くのファイル操作に対するパス検証を追加。
   • 新しいシステム情報検索インターフェイスを開発。

3. 第 3 段階：拡張機能の実装

   • ドライブマッピングとネットワーク共有のサポートを導入（Windows 用）。
   • ディレクトリツリー構造の表示機能を強化。
   • より高度なファイル検索アルゴリズムを実装。

プロジェクト構造

- README.md：プロジェクトの説明と使用方法
- LICENSE：MIT ライセンス
- requirements.txt：Python 依存関係のリスト
- fs_server.py：メインサーバーファイル
- schemas：Pydantic データ検証モデル
- tools：機能実装ツールモジュール

設定

1. Claude の設定
   • claude_desktop_config.json ファイルを編集します。
   • 以下の内容を追加します。

     {
       "file_system_tools": {
         "command": "/usr/bin/python3",
         "args": [
           "/path/to/fs_server.py"
         ]
       }
     }
     

   • ファイルを保存し、Claude を再起動します。

使用方法

ファイル操作

• copy_file：ファイルをコピーし、必要に応じてバックアップを作成。
• move_file：ファイルを移動し、必要に応じてバックアップを作成。
• delete_file：安全にファイルを削除（確認メカニズム付き）。
• read_file：ファイル内容を読み取り、文字列として返す。
• write_file：内容をファイルに書き込む。
• get_file_info：ファイルの詳細情報を取得。
• search_files：名前でファイルを検索。
• create_collection：ファイルコレクションを作成。

ディレクトリ操作

• list_directory：ディレクトリ内容を一覧表示。
• create_directory：新しいディレクトリを作成。
• delete_directory：ディレクトリを削除。
• list_directory_recursively：ディレクトリ構造をツリー形式で表示。
• search_directories：名前でディレクトリを検索。

システム情報

• get_system_info：システムのハードウェアとソフトウェア情報を取得。
• get_disk_info：ディスク使用状況を取得。
• get_directory_info：ディレクトリの統計情報を取得。

既知の問題

1. ファイル削除機能

   • delete_file 関数は、特定の状況で正常に動作しない場合があります。手動で検証するか、他の方法を使用して削除することをお勧めします。

2. ドライブリスト機能

   • list_drives 関数は、すべての利用可能なドライブを正しく検出できない場合があり、一部のドライブが欠落または誤った情報を表示することがあります。

3. プラットフォーム制限

   • Windows 固有の機能は、macOS/Linux では使用できません。
   • 異なるプラットフォーム間でのパス処理とシステム情報検索には差異がある場合があります。

エラー処理

• すべてのファイルおよびディレクトリ操作には、詳細なエラーキャプチャとログ記録メカニズムが備わっています。
• 統一された例外処理インターフェイスを提供し、ユーザーが正確なエラー情報を取得できるようにします。

セキュリティ

• ファイル操作では、デフォルトでパス検証機能が有効になっており、悪意のあるパス注入攻撃を防止します。
• システム情報検索は、厳格なセキュリティ審査を受けており、機密情報が漏洩しないようにしています。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。使用および配布する際には、関連する条項を遵守してください。