Ai Yliu Filesystem MCP Server

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

Claude AIに対して、ファイルシステム操作を提供するモデルコンテキストプロトコル (MCP) サーバです。

✨ 主な機能

このMCPサーバは、以下のファイルシステム操作を提供します。

1. read_file: ファイルの全内容を読み取ります。

   • 入力: path（文字列）
   • UTF-8エンコーディングを使用して、ファイルの全内容を読み取ります。

2. read_multiple_files: 複数のファイルを同時に読み取ります。

   • 入力: paths（文字列配列）
   • 読み取りに失敗しても、全体の操作は続行されます。

3. write_file: 新しいファイルを作成するか、既存のファイルを上書きします。

   • 入力:
     • path（文字列）：ファイルの場所
     • content（文字列）：ファイルの内容

4. create_directory: 新しいディレクトリを作成するか、ディレクトリが存在することを確認します。

   • 入力: path（文字列）
   • 必要に応じて、親ディレクトリを作成します。
   • ディレクトリが既に存在する場合は、無事に成功します。

5. list_directory: ディレクトリの内容を [FILE] または [DIR] の接頭辞付きでリストします。

   • 入力: path（文字列）

6. move_file: ファイルやディレクトリを移動またはリネームします。

   • 入力:
     • source（文字列）
     • destination（文字列）
   • 目標が既に存在する場合は、操作は失敗します。

7. search_files: ファイル/ディレクトリを再帰的に検索します。

   • 入力:
     • path（文字列）：検索の開始ディレクトリ
     • pattern（文字列）：検索パターン
   • 大文字小文字を区別せずにマッチングします。
   • 完全なパスのマッチング項目を返します。

8. get_file_info: ファイル/ディレクトリの詳細なメタデータを取得します。

   • 入力: path（文字列）
   • 返り値:
     • サイズ
     • 作成時間
     • 更新時間
     • アクセス時間
     • タイプ（ファイル/ディレクトリ）
     • 権限

9. list_allowed_directories: サーバがアクセスを許可されているすべてのディレクトリをリストします。

   • 入力不要
   • このサーバが読み書きアクセスできるディレクトリを返します。

🔒 セキュリティ

サーバは、コマンドライン引数で指定されたディレクトリ内での操作のみを許可します。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします: npm install
3. プロジェクトをビルドします: npm run build

💻 使用例

基本的な使用法

以下のコマンドを使用してサーバを起動します。

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

設定例

このサーバをMCP設定ファイルに追加します。

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

📄 ライセンス

ISC