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

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

特徴

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

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

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

• ファイルを検索

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

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

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 (文字列)

  • 戻り値:

    • サイズ

    • 作成時間

    • 修正時間

    • アクセス時間

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

    • 権限

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

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

  • 入力不要

  • 戻り値:

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

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

注: サンドボックス化されたディレクトリを/projectsにマウントすることで、サーバーに提供できます。ro フラグro追加すると、ディレクトリはサーバーによって読み取り専用になります。

ドッカー

注意: すべてのディレクトリは、デフォルトで/projectsにマウントする必要があります。

NPX

VS Codeでの使用

すぐにインストールするには、以下のインストールボタンをクリックしてください...

手動でインストールする場合は、VS Code のユーザー設定 (JSON) ファイルに次の JSON ブロックを追加します。Ctrl Ctrl + Shift + Pを押してPreferences: Open Settings (JSON)と入力すると、このブロックを追加できます。

オプションとして、ワークスペース内の.vscode/mcp.jsonというファイルに追加することもできます。これにより、他のユーザーと設定を共有できるようになります。

.vscode/mcp.jsonファイルではmcpキーは必要ないことに注意してください。

サンドボックス化されたディレクトリをサーバーに提供するには、 /projectsにマウントします。ro roを追加すると、そのディレクトリはサーバーによって読み取り専用になります。

ドッカー

注意: すべてのディレクトリは、デフォルトで/projectsにマウントする必要があります。

NPX

建てる

Dockerビルド:

ライセンス

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