Support mesh collections

Author: vibegui

local-fs/README.md

@@ -1,14 +1,15 @@
 # @decocms/mcp-local-fs
 
-Mount any local filesystem path as an MCP server. Supports both **stdio** (default) and **HTTP** transports.
+Mount any local filesystem path as an MCP server. **Drop-in replacement** for the official MCP filesystem server, with additional MCP Mesh collection bindings.
 
 ## Features
 
 - 📁 Mount any filesystem path dynamically
 - 🔌 **Stdio transport** (default) - works with Claude Desktop, Cursor, and other MCP clients
 - 🌐 **HTTP transport** - for MCP Mesh integration
-- 🛠️ Full file operations: read, write, delete, move, copy, mkdir
-- 📋 Collection bindings for Files and Folders
+- 🛠️ **Full MCP filesystem compatibility** - same tools as the official server
+- 📋 **Collection bindings** for Files and Folders (Mesh-compatible)
+- 🔄 **Backward compatible** - supports both official and Mesh tool names
 - ⚡ Zero config needed
 
 ## Quick Start
@@ -84,18 +85,57 @@ Or use the path in URL format:
 
 ## Available Tools
 
+### Official MCP Filesystem Tools
+
+These tools follow the exact same schema as the [official MCP filesystem server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem):
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read a file (deprecated, use `read_text_file`) |
+| `read_text_file` | Read a text file with optional head/tail params |
+| `read_media_file` | Read binary/media files as base64 |
+| `read_multiple_files` | Read multiple files at once |
+| `write_file` | Write content to a file |
+| `edit_file` | Search/replace edits with diff preview |
+| `create_directory` | Create a directory (with nested support) |
+| `list_directory` | List files and directories |
+| `list_directory_with_sizes` | List with file sizes |
+| `directory_tree` | Recursive tree view as JSON |
+| `move_file` | Move or rename files/directories |
+| `search_files` | Search files by glob pattern |
+| `get_file_info` | Get detailed file/directory metadata |
+| `list_allowed_directories` | Show allowed directories |
+
+### Additional Tools
+
+| Tool | Description |
+|------|-------------|
+| `delete_file` | Delete a file or directory (with recursive option) |
+| `copy_file` | Copy a file to a new location |
+
+### MCP Mesh Collection Bindings
+
+These tools provide standard collection bindings for MCP Mesh compatibility:
+
 | Tool | Description |
 |------|-------------|
-| `FILE_READ` | Read file content (utf-8 or base64) |
-| `FILE_WRITE` | Write content to a file |
-| `FILE_DELETE` | Delete a file or directory |
-| `FILE_MOVE` | Move or rename a file/directory |
-| `FILE_COPY` | Copy a file |
-| `FILE_MKDIR` | Create a directory |
-| `COLLECTION_FILES_LIST` | List files (with optional recursion) |
-| `COLLECTION_FILES_GET` | Get file metadata |
-| `COLLECTION_FOLDERS_LIST` | List folders |
-| `COLLECTION_FOLDERS_GET` | Get folder metadata |
+| `COLLECTION_FILES_LIST` | List files with pagination |
+| `COLLECTION_FILES_GET` | Get file metadata and content by path |
+| `COLLECTION_FOLDERS_LIST` | List folders with pagination |
+| `COLLECTION_FOLDERS_GET` | Get folder metadata by path |
+
+### MCP Mesh Compatibility Aliases
+
+For backward compatibility with existing Mesh connections, these aliases are also available:
+
+| Mesh Tool | Maps To |
+|-----------|---------|
+| `FILE_READ` | `read_text_file` |
+| `FILE_WRITE` | `write_file` |
+| `FILE_DELETE` | `delete_file` |
+| `FILE_MOVE` | `move_file` |
+| `FILE_COPY` | `copy_file` |
+| `FILE_MKDIR` | `create_directory` |
 
 ## Environment Variables
 
@@ -116,6 +156,9 @@ npm run dev:stdio
 # Run in http mode (development)
 npm run dev
 
+# Run tests
+npm test
+
 # Type check
 npm run check