Filesys

🚀 文件システム MCP サーバ

安全なモデルコンテキストプロトコル（MCP）サーバで、指定されたディレクトリへのファイルシステム操作を制御されたアクセスで提供します。

✨ 主な機能

• 環境変数によるディレクトリアクセスの制御
• 許可されたディレクトリ内でのみファイル操作が可能
• スレッドセーフなキャッシュによる許可ディレクトリ機能
• 空白を含むパスの正しい処理

📦 インストール

go get github.com/gomcpgo/filesys

📚 ドキュメント

設定

環境変数を使用して許可されたディレクトリを設定します。

export MCP_ALLOWED_DIRS="/path1,/path2,/path with spaces/dir3"

ツールセット

ファイル読み取り

• read_file：単一のファイル内容を読み取ります。
• read_multiple_files：複数のファイルを同時に読み取ります。

ファイル書き込み

• write_file：ファイルを作成または上書きします。

ディレクトリ操作

• create_directory：新しいディレクトリを作成します。
• list_directory：ディレクトリの内容を一覧表示します。
• list_allowed_directories：アクセス可能なディレクトリを表示します。

ファイル管理

• move_file：ファイルやディレクトリを移動またはリネームします。
• get_file_info：ファイルのメタデータを取得します。
• search_files：パターンマッチングを使用してファイルを再帰的に検索します。

Claude Desktop との統合

claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/filesys",
      "env": {
        "MCP_ALLOWED_DIRS": "/path1,/path2,/path with spaces/dir3"
      }
    }
  }
}

安全性

• すべての操作は許可されたディレクトリに制限されます。
• パストラバーサル攻撃を防止します。
• 操作前に権限検証を行います。
• エラーとログの正しい処理を行います。

ビルド

go build -o bin/filesys cmd/main.go

💻 使用例

基本的な使用法

ファイルの読み取り

{
    "name": "read_file",
    "arguments": {
        "path": "/allowed/path/file.txt"
    }
}

ディレクトリ内容の一覧表示

{
    "name": "list_directory",
    "arguments": {
        "path": "/allowed/path"
    }
}

📄 ライセンス

MIT License

プロジェクトへの貢献

プルリクエストの投稿を歓迎します。以下を確認してください。

• テストが通過すること。
• 新機能にはドキュメントが含まれること。
• コードがプロジェクトのスタイルに従っていること。