🛠️ MCP Dev Tools Documentation
Complete documentation for MCP Dev Tools - File & Directory Operations for Autonomous AI Development
🚀 Quick Navigation
Getting Started
- 🎯 Start Here - Your first MCP dev tools experience
- 📖 Installation Guide - Complete installation instructions
- ⚡ Quick Start - Get up and running in 5 minutes
User Guides
- 🔒 Security Guide - Security best practices
- ✅ Testing Guide - Testing your implementation
- 🔄 Migration Guide - Upgrading between versions
Development
- 🤖 Working with Claude - AI collaboration guide
- 📦 Package Management - Dependency management
- 💡 Lessons Learned - Project insights
Maintenance
- 🔧 Build Fixes - Common build issues
- 🆘 Troubleshooting - Problem solving
- 📝 Changelog - Version history
📊 Project Overview
MCP Dev Tools provides 14 powerful tools for file and directory operations, designed for autonomous AI development with enterprise-grade security.
Key Features
✅ 14 MCP Tools - Complete file & directory operations
🔒 Enterprise Security - Path validation, rate limiting, protected paths
🤖 85% Autonomous - Automated package management & validation
📦 Zero Vulnerabilities - All dependencies up-to-date and secure
✨ TypeScript - Full type safety with strict mode
📚 Comprehensive Docs - Complete documentation in English
Statistics
| Metric | Value |
|---|---|
| MCP Tools | 14 (7 file + 4 dir + 3 search) |
| Dependencies | 2 production, 10 dev |
| Security Issues | 0 |
| Build Status | ✅ Passing |
| Test Coverage | Ready for tests |
| Documentation | Complete |
🎯 Quick Start
# Install
npm install @mcp-servers/dev-tools
# Configure in Claude Desktop
# Add to config file...
🛠️ Available Tools
File Operations (7)
read_file- Read file contents- Supports text and binary files
- UTF-8 and Base64 encoding
- Size limits for safety
write_file- Create/write files- Automatic parent directory creation
- Overwrite protection
- Backup on overwrite
rename_file- Rename or move files- Atomic operations
- Automatic directory creation
- Backup support
delete_file- Delete files (with backup)- Mandatory confirmation
- Automatic backup creation
- Safe deletion with validation
copy_file- Copy files- Timestamp preservation
- Overwrite protection
- Progress for large files
file_exists- Check file existence- Returns existence status
- File type detection
- Fast validation
get_file_info- Get file metadata- Size, timestamps, permissions
- MIME type detection
- Complete file information
Directory Operations (4)
list_directory- List directory contents with filters- Recursive traversal with depth control
- File type filtering (by extension)
- Multiple sort options (name, size, modified)
- Hidden file inclusion
- Pattern matching (glob support)
- Statistics (total files, directories, size)
create_directory- Create directories- Recursive parent creation
- Unix permissions support
- Duplicate detection
- Safe path validation
delete_directory- Delete directories (secure)- Mandatory confirmation requirement
- Recursive deletion support
- Automatic backup creation
- Content counting before deletion
- Force flag for non-empty directories
move_directory- Move/rename directories- Directory merging support
- Automatic backup on overwrite
- Content preservation
- Cross-directory moves
Search Operations (3)
search_files- Search files by name/pattern- Name/pattern matching (glob and regex)
- Case-sensitive/insensitive options
- File type filtering
- Relevance scoring
- Result caching (5 min TTL)
- Exclusion patterns
- Max results limit
search_content- Search within file contents- Full-text search (grep-like)
- Regex support
- Whole word matching
- Context lines (before/after)
- File type filtering
- Binary file detection and skip
- Line number and column tracking
find_duplicates- Find duplicate files- Hash-based comparison (MD5)
- Name-based comparison
- Size+name comparison options
- Wasted space calculation
- Original file marking
- Size filtering (min/max)
- Result caching (15 min TTL)
🔒 Security Features
- Path Validation - Prevents path traversal attacks
- Rate Limiting - Configurable limits per operation
- Protected Paths - Automatically excludes sensitive directories
- Backup System - Automatic backups before destructive operations
- Logging - Complete operation logging for audit
- Workspace Isolation - Operations limited to workspace directory
📚 Documentation Structure
docs/
├── getting-started/ # Installation & quick start
├── guides/ # User guides (security, testing, migration)
├── development/ # For contributors
└── maintenance/ # Keeping up-to-date
🤝 Contributing
We welcome contributions! See our Working with Claude guide for development guidelines.
📝 License
MIT © 2025 Thibaut Pontieux
🔗 Links
Last updated: October 21, 2025
Version: 1.2.0
Status: ✅ Production Ready