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

ファイルシステム操作用のモデル コンテキスト プロトコル (MCP) を実装する Node.js サーバー SSE。

特徴

• ファイルの読み取り/書き込み

• ディレクトリの作成/一覧表示/削除

• ファイル/ディレクトリを移動する

• ファイルを検索

• ファイルのメタデータを取得する

注意: サーバーは、 argsで指定されたディレクトリ内でのみ操作を許可します。

Related MCP server: MCP Local File Reader

API

リソース

• file://system : ファイルシステム操作インターフェース

ツール

• 読み取りファイル

  • ファイルの完全な内容を読み取る

  • 入力: path (文字列)

  • UTF-8エンコードでファイル内容全体を読み取ります

• 複数のファイルを読み取る

  • 複数のファイルを同時に読み取る

  • 入力: paths (文字列[])

  • 読み取りに失敗しても操作全体が停止することはない

• 書き込みファイル

  • 新しいファイルを作成するか、既存のファイルを上書きします（注意が必要です）

  • 入力:

    • path （文字列）: ファイルの場所

    • content (文字列): ファイルの内容

• 編集ファイル

  • 高度なパターンマッチングと書式設定を使用して選択的な編集を行う

  • 特徴：

    • 行ベースおよび複数行のコンテンツマッチング

    • インデントを保持した空白の正規化

    • 正しい位置で複数の編集を同時に行う

    • インデントスタイルの検出と保存

    • コンテキスト付きのGitスタイルのdiff出力

    • ドライランモードで変更をプレビューする

  • 入力:

    • path （文字列）：編集するファイル

    • edits （配列）：編集操作のリスト

      • oldText (文字列): 検索するテキスト（部分文字列も可）

      • newText (文字列): 置換するテキスト

    • dryRun (ブール値): 変更を適用せずにプレビューします (デフォルト: false)

  • ドライランの詳細な差分と一致情報を返し、それ以外の場合は変更を適用します

  • ベストプラクティス: 変更を適用する前に必ず dryRun を使用して変更をプレビューしてください。

• ディレクトリの作成

  • 新しいディレクトリを作成するか、存在することを確認します

  • 入力: path (文字列)

  • 必要に応じて親ディレクトリを作成します

  • ディレクトリが存在する場合は、何もせずに成功します

• リストディレクトリ

  • [FILE]または[DIR]プレフィックスを持つディレクトリの内容を一覧表示します

  • 入力: path (文字列)

• ファイルの移行

  • ファイルとディレクトリの移動または名前の変更

  • 入力:

    • source （文字列）

    • destination （文字列）

  • 宛先が存在する場合は失敗します

• 検索ファイル

  • ファイル/ディレクトリを再帰的に検索する

  • 入力:

    • path （文字列）：開始ディレクトリ

    • pattern (文字列): 検索パターン

    • excludePatterns (string[]): パターンを除外します。glob形式がサポートされています。

  • 大文字と小文字を区別しないマッチング

  • 一致するフルパスを返します

• ファイル情報を取得する

  • 詳細なファイル/ディレクトリのメタデータを取得する

  • 入力: path (文字列)

  • 戻り値:

    • サイズ

    • 作成時間

    • 修正時間

    • アクセス時間

    • タイプ（ファイル/ディレクトリ）

    • 権限

• 許可されたディレクトリの一覧

  • サーバーがアクセスを許可されているすべてのディレクトリを一覧表示します

  • 入力不要

  • 戻り値:

    • このサーバーが読み取り/書き込みできるディレクトリ

実行と使用方法

地元

1. ビルド:

npm install

2.1 Windows を実行する:

node .\dist\index.js C:\Users\User

許可されたディレクトリ: C:\Users\User

2.2 Macos / Linux を実行する:

node ./dist/index.js /Users

許可されたディレクトリ: /Users

3. 設定:

{
  "mcpServers": {
    "file_system": {
      "name": "file_system",
      "baseUrl": "http://127.0.0.1:3001/sse"
    }
  }
}

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。