Calebmwelsh File System MCP Server

🚀 ファイルシステムサーバ

このプロジェクトはFastMCPフレームワークに基づいて構築されたファイルシステム管理サーバです。ファイルやディレクトリの複製、移動、削除などの操作機能を提供し、システム情報の取得もサポートしています。現在、Windowsプラットフォームで最も完全な機能を備えています。

🚀 クイックスタート

このファイルシステムサーバを使用するには、以下の手順に従ってください。

クローンと依存関係のインストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/file-system-server.git
cd file-system-server

2. 依存関係をインストールします。

pip install -r requirements.txt

3. claude_desktop_config.json をサンプルに基づいて編集し、正しいPythonインタープリターとサーバファイルのパスを指定します。

✨ 主な機能

ファイル操作

• copy_file：ファイルをコピーし、必要に応じてバックアップを作成できます。
• move_file：ファイルを移動し、必要に応じてバックアップを作成できます。
• delete_file：ファイルを安全に削除します。
• read_file：ファイルの内容を読み取ります。
• write_file：ファイルに内容を書き込みます。
• get_file_info：ファイルの詳細情報を取得します。
• search_files：名前でファイルを検索します。

ディレクトリ操作

• list_directory：ディレクトリの内容を一覧表示します。
• create_directory：新しいディレクトリを作成します。
• delete_directory：ディレクトリを削除します。
• list_directory_recursively：ディレクトリ構造を再帰的に表示します。
• search_directories：名前でディレクトリを検索します。

システム情報

• get_system_info：システムの基本情報を取得します。
• get_disk_info：ディスクの使用状況を調べます。

📦 インストール

依存関係をインストールするには、以下のコマンドを実行してください。

pip install -r requirements.txt

📚 ドキュメント

プロジェクト構造

file-system-server/
├── fs_server.py                  # 主要なファイルシステムサービスの実装
├── windows_utils.py             # Windowsプラットフォーム固有の機能モジュール
├── requirements.txt              # 依存関係のリスト
└── claude_desktop_config.json   # Claudeデスクトップの設定サンプル

プラットフォームサポート

• Windows：ドライブリスト、特殊フォルダへのアクセス、システム情報など、完全な機能をサポートしています。
• macOS/Linux：ファイル操作やディレクトリ管理などの基本機能のみをサポートしています。

🔧 技術詳細

既知の問題

• ファイル削除機能：一部のファイルを正しく削除できない場合があります。手動で確認することをおすすめします。
• ドライブ一覧機能：すべての利用可能なドライブを検出できないか、エラーメッセージが表示される場合があります。

セキュリティ上の注意事項

• すべてのファイル操作にはパス検証が含まれています。
• 破壊的な操作の前にバックアップファイルを作成します。
• システム情報へのアクセス権限を厳格に制限します。

🤝 貢献ガイド

このプロジェクトに貢献するには、以下の手順に従ってください。

1. リポジトリをForkします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. Pull Requestを提出します。

📄 ライセンス

このプロジェクトはMIT Licenseに従います。詳細は LICENSE ファイルを参照してください。

⚠️ 重要提示

この翻訳内容は表示用です。実際の使用時は元の英文ドキュメントを参照してください。