Customable - MCPs
Repositories
49
 Projects Packages
17

@customable/filesystem-mcp (2.0.0)

Published 2025-10-10 12:10:00 +02:00 by jack in customable-mcp/filesystem-mcp

Installation

@customable:registry=
npm install @customable/filesystem-mcp@2.0.0
"@customable/filesystem-mcp": "2.0.0"

About this package

📁 filesystem-mcp

Version CI Status License NPM

MCP Server for secure filesystem operations.

🆕 What's New in v2.0.0

Complete Refactor with Enhanced Architecture

  • 🏗️ Modular Structure: Split into focused modules (types, tool-definitions, handlers, service) - 78% code reduction in index.ts
  • 🔒 100% Type Safety: Eliminated all any types with proper TypeScript interfaces
  • 📚 Complete Documentation: Full JSDoc coverage for all public APIs
  • 🧪 Comprehensive Testing: 19 unit tests with 100% pass rate
  • 📦 Updated Dependencies: MCP SDK upgraded from 0.5.0 → 1.20.0
  • 🔐 Enhanced Security: Path validation, sandboxed operations, file size limits
  • 🎯 Glob Patterns: Advanced file filtering with glob pattern support

See CHANGELOG.md for complete details.

Features

Core Operations

  • 📖 read_file - Read file contents
  • ✍️ write_file - Write file contents
  • 📋 list_files - List files in directory
  • 🔍 search_files - Search in files
  • 🗂️ create_directory - Create directory
  • 🗑️ delete_file - Delete file
  • 📊 get_file_info - Get file metadata

Security

  • Path traversal prevention
  • Sandboxed operations
  • Configurable allowed directories
  • File size limits

Installation

npm install
npm run build

Usage

npm start

Configuration

Set environment variables:

  • ALLOWED_PATHS - Comma-separated list of allowed base paths
  • MAX_FILE_SIZE - Maximum file size in bytes (default: 10MB)

License

MIT

Dependencies

Dependencies

ID Version
@types/glob ^8.1.0
glob ^11.0.3
zod ^3.23.8

Development dependencies

ID Version
@modelcontextprotocol/sdk ^1.20.0
@types/node ^22.0.0
@vitest/coverage-v8 ^3.2.4
typescript ^5.5.0
vitest ^3.2.4

Keywords

mcp filesystem file-operations mcp-server
Details
npm
customable-mcp/filesystem-mcp
2025-10-10 12:10:00 +02:00
2
Customable Team
Project website
MIT
latest
16 KiB
Assets (1)
filesystem-mcp-2.0.0.tgz 16 KiB
Versions (2) View all
2.0.0 2025-10-10
1.0.5 2025-10-07
Issues