Filesystem

🚀 文件システム MCP サーバ

Claude AIに対して、ファイルシステム操作を提供するModel Context Protocol (MCP) サーバです。

✨ 主な機能

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

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

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

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

   • 入力: paths（文字列配列）
   • 読み取りに失敗した場合でも、全体の操作は停止しません。

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

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

4. ディレクトリの作成: 新しいディレクトリを作成するか、既に存在する場合は何もしません。

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

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

   • 入力: path（文字列）

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

   • 入力:
     • source（文字列）
     • destination（文字列）
   • 目的の場所に既にファイルが存在する場合は、操作は失敗します。

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

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

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

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

9. 許可されたディレクトリの一覧表示: サーバがアクセスできるすべてのディレクトリを一覧表示します。

   • 入力不要
   • サーバが読み取り/書き込みできるディレクトリを返します。

🔒 セキュリティ

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

📦 インストール

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