mcpField
F
Filesystem

Filesystem

ローカル
github.comファイル・ストレージ34 日前に更新
リポジトリ公式サイト

Filesystem について

Filesystemは、ファイルの読み取り、作成、編集を行うMCPサーバーです。表示、上書き、文字列の完全一致置換、行を指定した挿入に対応するツールを備えています。

主な機能

  1. 01ファイルの読み取りとディレクトリ一覧
  2. 02ファイルの作成・上書き
  3. 03文字列の完全一致置換
  4. 04指定行へのテキスト挿入

活用シーン

  1. 01メール添付ファイルのフォルダー保存
  2. 02設定値の更新
  3. 03カレンダーの要約をノートに保存
  4. 04ファイル内の関数名のリファクタリング

MCP 対応

Filesystemは、view、create、str_replace、insertなどのファイル読み書きツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "domdomegg-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
起動コマンドnpx -y filesystem-mcp
設定が必要な環境変数
MCP_TRANSPORTTransport type.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmfilesystem-mcp1.3.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

filesystem-mcp

ファイルシステム操作（ファイルの読み取り、作成、編集）用の MCP サーバーです。

ユースケース

メールの添付ファイルを保存：「今月、会計士から届いたメールに含まれる PDF をすべてダウンロードして」→ 条件に一致するメールを Gmail で検索し、添付ファイルを取り出してローカルフォルダーに保存します。

設定ファイルを更新：「設定ファイルの API エンドポイントをステージングから本番環境に変更して」→ 設定ファイルを見つけて URL を置き換え、差分を表示します。

レポートを生成：「今日のカレンダーの予定をまとめて」→ カレンダーを読み取り、Markdown レポートを作成してノートフォルダーに保存します。

コードのリファクタリング：src/api.ts 内の関数 getData を fetchUserData に変更して」→ ファイルを読み取り、指定された箇所を正確に置き換えて、変更を確認します。

変更前のバックアップ：「変更を加える前に .zshrc のコピーを保存して」→ 現在のファイルを読み取り、タイムスタンプ付きのバックアップを書き込みます。

セットアップ

install-mcp の手順に従ってください。お使いの MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

ツール

ツール説明
viewファイルの内容を読み取るか、ディレクトリを一覧表示します（行番号付き）。
createファイルを作成または上書きします。
str_replaceファイル内の完全一致する文字列を置き換えます。
insert指定した行にテキストを挿入します。

コントリビューション

GitHub でのプルリクエストを歓迎します。始めるには、次の手順に従ってください。

  1. Git と Node.js をインストールします
  2. リポジトリをクローンします
  3. npm install で依存関係をインストールします
  4. npm run test を実行してテストを実行します
  5. npm run build でビルドします

リリース

バージョンにはセマンティック バージョニング仕様を使用しています。

リリースするには、次の手順に従ってください。

  1. npm version <major | minor | patch> を使用してバージョンを更新します
  2. git push --follow-tags を実行してタグとともにプッシュします
  3. GitHub Actions による NPM レジストリへの公開を待ちます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。