{"_id":"@decocms/mcp-local-fs","_rev":"7-025d92a648c70e32cb4110d414b43fb9","name":"@decocms/mcp-local-fs","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@decocms/mcp-local-fs","version":"1.0.0","keywords":["mcp","model-context-protocol","filesystem","local-fs","ai","claude","mesh","stdio"],"author":{"name":"DecoCMS"},"license":"MIT","_id":"@decocms/mcp-local-fs@1.0.0","maintainers":[{"name":"camudo","email":"viktor@deco.cx"},{"name":"gimenes-decocx","email":"gimenes@deco.cx"},{"name":"firstdoit","email":"gadr90@gmail.com"}],"homepage":"https://github.com/decocms/mcps#readme","bugs":{"url":"https://github.com/decocms/mcps/issues"},"bin":{"mcp-local-fs":"dist/cli.js"},"dist":{"shasum":"2e5b0dc424fc227a188c6de6653fddc14ecbe2eb","tarball":"https://registry.npmjs.org/@decocms/mcp-local-fs/-/mcp-local-fs-1.0.0.tgz","fileCount":14,"integrity":"sha512-vTMH8dH4/o18GBsH2vom9OZErdShcoqmP4093g/d4/G15KUNuqHU7Wr+B1VWHtxQBPy7TQPdK2dzvApkkTyVFQ==","signatures":[{"sig":"MEQCIB1rOE98y3RZNnnYlm2AeoV4+SyFL18iD9xaIeDTPipKAiApKszBnCgx+wX5hxy7QBEQJmRcspvc2JDEM5l1OeiJaA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90855},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","engines":{"node":">=20.0.0"},"gitHead":"9fb912cb09f760b1db214fa06b6da92de25f60b3","scripts":{"dev":"bun run server/http.ts","test":"bun test","build":"tsc","check":"tsc --noEmit","start":"node dist/cli.js","dev:stdio":"bun run server/stdio.ts","start:http":"node dist/cli.js --http","test:watch":"bun test --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"firstdoit","email":"gadr90@gmail.com"},"repository":{"url":"git+https://github.com/decocms/mcps.git","type":"git","directory":"local-fs"},"_npmVersion":"10.9.4","description":"MCP server that mounts any local filesystem path. Supports stdio (default) and HTTP transports.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-local-fs_1.0.0_1767118794431_0.361941136625735","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@decocms/mcp-local-fs","version":"1.0.1","keywords":["mcp","model-context-protocol","filesystem","local-fs","ai","claude","mesh","stdio"],"author":{"name":"DecoCMS"},"license":"MIT","_id":"@decocms/mcp-local-fs@1.0.1","maintainers":[{"name":"camudo","email":"viktor@deco.cx"},{"name":"gimenes-decocx","email":"gimenes@deco.cx"},{"name":"firstdoit","email":"gadr90@gmail.com"}],"homepage":"https://github.com/decocms/mcps#readme","bugs":{"url":"https://github.com/decocms/mcps/issues"},"bin":{"mcp-local-fs":"dist/cli.js"},"dist":{"shasum":"2894b46595a75c0ff4b509d8da6d992ef943338a","tarball":"https://registry.npmjs.org/@decocms/mcp-local-fs/-/mcp-local-fs-1.0.1.tgz","fileCount":16,"integrity":"sha512-bPcFrEFgueiKOWVshGufBWWnjP2HGT1F7vbQXFabyK1jvtnGjhCcNmh7bMRqRA0SG1xQERYmNWSSdyw3QHKeIg==","signatures":[{"sig":"MEYCIQCoH6rD8/SeC1KUTw9KWuRAFXDzdSI2VboBtmursC2gHAIhAKJ4mxxfezIbfW03cSTl4jncddx5Bd/V+rB881tOkl1o","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96993},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","engines":{"node":">=20.0.0"},"gitHead":"d54afacc5e3b0379eeeb3c2003a0d46757b42626","scripts":{"dev":"bun run server/http.ts","test":"bun test","build":"tsc","check":"tsc --noEmit","start":"node dist/cli.js","dev:stdio":"bun run server/stdio.ts","start:http":"node dist/cli.js --http","test:watch":"bun test --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"firstdoit","email":"gadr90@gmail.com"},"repository":{"url":"git+https://github.com/decocms/mcps.git","type":"git","directory":"local-fs"},"_npmVersion":"10.9.4","description":"MCP server that mounts any local filesystem path. Supports stdio (default) and HTTP transports.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-local-fs_1.0.1_1767128385443_0.7437890507410836","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@decocms/mcp-local-fs","version":"1.0.2","keywords":["mcp","model-context-protocol","filesystem","local-fs","ai","claude","mesh","stdio"],"author":{"name":"DecoCMS"},"license":"MIT","_id":"@decocms/mcp-local-fs@1.0.2","maintainers":[{"name":"camudo","email":"viktor@deco.cx"},{"name":"gimenes-decocx","email":"gimenes@deco.cx"},{"name":"firstdoit","email":"gadr90@gmail.com"}],"homepage":"https://github.com/decocms/mcps#readme","bugs":{"url":"https://github.com/decocms/mcps/issues"},"bin":{"mcp-local-fs":"dist/cli.js"},"dist":{"shasum":"5297b95f2749fb80caf9aa1a68a38f14ea6674e3","tarball":"https://registry.npmjs.org/@decocms/mcp-local-fs/-/mcp-local-fs-1.0.2.tgz","fileCount":16,"integrity":"sha512-dcdA+75t6U/JVd5N5ShzRsPiJxnilkhVRcnV+IZxIuaCvLexLaF6XY/jbwUjOPK+/FeZ0XM6I/saa73EP1mglg==","signatures":[{"sig":"MEYCIQCkWVTYK3SOk5N5AuU59bPLvbPsRvLLVxwKeCQO5mEmNwIhAII80IvClZbnAyY/ITArncDIZSSrfrw8McN6seCOSFFM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98253},"main":"./dist/cli.js","type":"module","types":"./dist/cli.d.ts","engines":{"node":">=20.0.0"},"gitHead":"b307c0a0497e069328e1aff5a99688cc70a14701","scripts":{"dev":"bun run server/http.ts","test":"bun test","build":"tsc","check":"tsc --noEmit","start":"node dist/cli.js","dev:stdio":"bun run server/stdio.ts","start:http":"node dist/cli.js --http","test:watch":"bun test --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"firstdoit","email":"gadr90@gmail.com"},"repository":{"url":"git+https://github.com/decocms/mcps.git","type":"git","directory":"local-fs"},"_npmVersion":"10.9.4","description":"MCP server that mounts any local filesystem path. Supports stdio (default) and HTTP transports.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.20.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-local-fs_1.0.2_1767133448263_0.2193611435335141","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-12-30T18:19:54.329Z","modified":"2026-07-07T21:03:52.084Z","1.0.0":"2025-12-30T18:19:54.603Z","1.0.1":"2025-12-30T20:59:45.578Z","1.0.2":"2025-12-30T22:24:08.399Z"},"bugs":{"url":"https://github.com/decocms/mcps/issues"},"author":{"name":"DecoCMS"},"license":"MIT","homepage":"https://github.com/decocms/mcps#readme","keywords":["mcp","model-context-protocol","filesystem","local-fs","ai","claude","mesh","stdio"],"repository":{"url":"git+https://github.com/decocms/mcps.git","type":"git","directory":"local-fs"},"description":"MCP server that mounts any local filesystem path. Supports stdio (default) and HTTP transports.","maintainers":[{"email":"viktor@deco.cx","name":"camudo"},{"email":"nnicacio@gmail.com","name":"nicacioliveira"},{"email":"gimenes@deco.cx","name":"gimenes-decocx"},{"email":"fernandofrizzatti@gmail.com","name":"crazydevil"},{"email":"jonasjesus@deco.cx","name":"jonasjesus"},{"email":"gadr90@gmail.com","name":"firstdoit"},{"email":"vinicius.ventura@decocms.com","name":"vinventura"}],"readme":"# @decocms/mcp-local-fs\n\nMount any local filesystem path as an MCP server. **Drop-in replacement** for the official MCP filesystem server, with additional MCP Mesh collection bindings.\n\n## Features\n\n- 📁 Mount any filesystem path dynamically\n- 🔌 **Stdio transport** (default) - works with Claude Desktop, Cursor, and other MCP clients\n- 🌐 **HTTP transport** - for MCP Mesh integration\n- 🛠️ **Full MCP filesystem compatibility** - same tools as the official server\n- 📋 **Collection bindings** for Files and Folders (Mesh-compatible)\n- 🔄 **Backward compatible** - supports both official and Mesh tool names\n- ⚡ Zero config needed\n\n## Quick Start\n\n### Using npx (stdio mode - recommended for Claude Desktop)\n\n```bash\n# Mount current directory\nnpx @decocms/mcp-local-fs\n\n# Mount specific path\nnpx @decocms/mcp-local-fs /path/to/folder\n\n# Or with --path flag\nnpx @decocms/mcp-local-fs --path /path/to/folder\n```\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"local-fs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@decocms/mcp-local-fs\", \"/path/to/folder\"]\n    }\n  }\n}\n```\n\n### Cursor Configuration\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"local-fs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@decocms/mcp-local-fs\", \"/path/to/folder\"]\n    }\n  }\n}\n```\n\n### HTTP Mode (for MCP Mesh)\n\n```bash\n# Start HTTP server on port 3456\nnpx @decocms/mcp-local-fs --http\n\n# With custom port\nnpx @decocms/mcp-local-fs --http --port 8080\n\n# Mount specific path\nnpx @decocms/mcp-local-fs --http --path /your/folder\n```\n\nThen connect using:\n- `http://localhost:3456/mcp?path=/your/folder`\n- `http://localhost:3456/mcp/your/folder`\n\n## Adding to MCP Mesh\n\nAdd a new connection with:\n- **Transport**: HTTP  \n- **URL**: `http://localhost:3456/mcp?path=/your/folder`\n\nOr use the path in URL format:\n- **URL**: `http://localhost:3456/mcp/home/user/documents`\n\n## Available Tools\n\n### Official MCP Filesystem Tools\n\nThese tools follow the exact same schema as the [official MCP filesystem server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem):\n\n| Tool | Description |\n|------|-------------|\n| `read_file` | Read a file (deprecated, use `read_text_file`) |\n| `read_text_file` | Read a text file with optional head/tail params |\n| `read_media_file` | Read binary/media files as base64 |\n| `read_multiple_files` | Read multiple files at once |\n| `write_file` | Write content to a file |\n| `edit_file` | Search/replace edits with diff preview |\n| `create_directory` | Create a directory (with nested support) |\n| `list_directory` | List files and directories |\n| `list_directory_with_sizes` | List with file sizes |\n| `directory_tree` | Recursive tree view as JSON |\n| `move_file` | Move or rename files/directories |\n| `search_files` | Search files by glob pattern |\n| `get_file_info` | Get detailed file/directory metadata |\n| `list_allowed_directories` | Show allowed directories |\n\n### Additional Tools\n\n| Tool | Description |\n|------|-------------|\n| `delete_file` | Delete a file or directory (with recursive option) |\n| `copy_file` | Copy a file to a new location |\n\n### MCP Mesh Collection Bindings\n\nThese tools provide standard collection bindings for MCP Mesh compatibility:\n\n| Tool | Description |\n|------|-------------|\n| `COLLECTION_FILES_LIST` | List files with pagination |\n| `COLLECTION_FILES_GET` | Get file metadata and content by path |\n| `COLLECTION_FOLDERS_LIST` | List folders with pagination |\n| `COLLECTION_FOLDERS_GET` | Get folder metadata by path |\n\n### MCP Mesh Compatibility Aliases\n\nFor backward compatibility with existing Mesh connections, these aliases are also available:\n\n| Mesh Tool | Maps To |\n|-----------|---------|\n| `FILE_READ` | `read_text_file` |\n| `FILE_WRITE` | `write_file` |\n| `FILE_DELETE` | `delete_file` |\n| `FILE_MOVE` | `move_file` |\n| `FILE_COPY` | `copy_file` |\n| `FILE_MKDIR` | `create_directory` |\n\n## Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `MCP_LOCAL_FS_PATH` | Default path to mount |\n| `PORT` | HTTP server port (default: 3456) |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in stdio mode (development)\nnpm run dev:stdio\n\n# Run in http mode (development)\nnpm run dev\n\n# Run tests\nnpm test\n\n# Type check\nnpm run check\n\n# Build for distribution\nnpm run build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}