Martinschlott BetterMCPFileServer

🚀 より良いMCPファイルサーバー

BetterMCPFileServerは、開発者向けに設計された、機能がより強力なMCPファイルサーバーです。ファイルとディレクトリの管理を行うためのシンプルで使いやすいインターフェースを提供し、ファイルの書き込み、読み取り、編集、移動、コピー、削除、およびファイルとディレクトリの検索をサポートしています。

✨ 主な機能

• 強力かつシンプル：6つの核心機能ですべてのファイル操作を処理します。
• 仮想ルートディレクトリ：エイリアス:パスのペアを定義することで、物理パスを仮想パスにマッピングします。
• 安全なサンドボックス：アクセス権限を厳格に制限し、操作を指定されたディレクトリに限定します。
• 柔軟な検索：Globパターンマッチングをサポートし、ファイルとディレクトリを効率的に検索できます。

📦 インストール

# npmから（近日公開予定）
npm install -g BetterMCPFileServer  # まだ利用できません

# ソースコードから（現在の方法）
git clone https://github.com/martinschlott/BetterMCPFileServer.git
cd BetterMCPFileServer
npm install
npm run build
npm link  # オプション、コマンドをグローバルで使用する場合

🚀 クイックスタート

サーバーを起動する際には、少なくとも1つのエイリアス:パスのペアが必要です。

BetterMCPFileServer エイリアス:ディレクトリ [エイリアス2:ディレクトリ2 ...]

例

# 単一のディレクトリ
BetterMCPFileServer code:~/projects

# 複数のディレクトリ
BetterMCPFileServer code:~/Development docs:~/Documents/Technical notes:~/Notes

🔧 高度な設定

一貫した設定を維持するために、簡単なシェルスクリプトを作成します。

#!/bin/bash
# start-server.sh
BetterMCPFileServer \
  code:~/Development/MyProjects \
  docs:~/Documents/Technical \
  data:~/Data/Samples \
  config:~/Configuration

💻 使用例

基本的なファイル操作

// ファイル内容を読み取る
const 内容 = await readFileContent({ filePath: "projects/README.md" });

// ファイルを書き込む
await writeFile({
  filePath: "projects/notes.txt",
  content: "重要会议笔记。"
});

// ファイルを編集する
await editFile({
  filePath: "projects/config.json",
  edits: [
    {
      oldText: '"version": "1.0.0"',
      newText: '"version": "1.0.1"'
    }
  ],
  dryRun: false
});

ディレクトリ操作

// 新しいディレクトリを作成する
await manageFolder({
  action: "create",
  folderPath: "projects/new-feature"
});

// ディレクトリの内容をリストする
const 文件 = await searchFilesAndFolders({
  pattern: "projects/src/*"
});

エラー解消

• エラー：無効なエイリアス:パス形式：各パラメータがエイリアス:ディレクトリ形式であることを確認してください。
• エラー：ディレクトリが存在しません：指定されたディレクトリは存在する必要があります。
• アクセス拒否エラー：許可されていないディレクトリにアクセスしようとしています。
• 未知のエイリアス：参照されているエイリアスがサーバー起動時に定義されていません。

クレジット

このプロジェクトは、Martin Schlott（概念と設計）がAIアシスタントと協力して完成させました。

• Claude 3.7 Sonnet（API設計のコンサルティングとドキュメント）
• Cursor AI（実装）

READMEファイルはClaudeによって生成されました

BetterMCPFileServerは、強力でシンプルなインターフェースを提供し、ファイルとディレクトリをより効率的に管理するのに役立ちます。エイリアス:パスのペアを定義することで、物理パスを仮想パスにマッピングし、アクセス権限を厳格に制限して、操作を指定されたディレクトリに限定することができます。ファイルの書き込み、読み取り、編集、移動、コピー、削除、およびファイルとディレクトリの検索をサポートしており、開発者に最適な選択肢です。

詳細情報については、プロジェクトのドキュメントを参照してください。