File Control MCP

🚀 Enhanced Directory Context MCP Server

A comprehensive Model Context Protocol (MCP) server that equips AI assistants like Claude with advanced directory analysis and file management capabilities.

🚀 Quick Start

This server integrates directory context extraction with full file editing capabilities, making it a powerful tool for code analysis, project management, and file operations.

Setup Steps

1. Install dependencies: npm install
2. Add the following configuration to your Claude Desktop config:

{
  "mcpServers": {
    "directory-context": {
      "command": "node",
      "args": ["path/to/server.js"]
    }
  }
}

✨ Features

🔍 Directory Analysis

• Complete Directory Structure: Obtain detailed tree views of any directory along with metadata.
• Intelligent Project Analysis: Automatically detect project types and summarize context.
• Smart File Search: Conduct regex and text-based searches across multiple file types.
• Git Integration: Extract repository context, commit history, and working directory status.
• File Statistics: Perform comprehensive analysis of file types, sizes, and modification dates.

📝 File Operations

• Create Files: Generate new files with specified content.
• Update Files: Conduct sophisticated search-and-replace operations with regex support.
• Append Content: Add content to existing files with formatting options.
• Delete Files: Remove files with optional backup creation.
• Rename/Move Files: Relocate and rename files with collision detection.
• Directory Management: Create directory structures recursively.

🔄 Advanced Features

• Batch Operations: Execute multiple file operations in a single transaction.
• Automatic Backups: Optionally create backups for destructive operations.
• Transaction Rollback: Roll back failed batch operations.
• Resource Exposure: Automatically expose important project files as MCP resources.
• Error Handling: Provide comprehensive error handling with detailed feedback.

📦 Installation

Prerequisites

• Node.js 18.0.0 or higher
• npm or yarn package manager

Setup

1. Clone or download the MCP server files.
2. Install dependencies:

npm install

3. Configure your MCP client (Claude Desktop, etc.) to use this server:

Claude Desktop Configuration: Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "directory-context": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "cwd": "your-default-working-directory"
    }
  }
}

Alternative Configuration: Use the provided mcp-json-config.json as a template and update the paths accordingly.

💻 Usage Examples

Setting Up Your Working Directory

Before using any features, set your working directory:

set_working_directory(directory="/path/to/your/project")

Directory Analysis Tools

Get Directory Structure

get_directory_structure(
  max_depth=10,           // Maximum traversal depth
  include_hidden=false,   // Include hidden files/directories
  file_types=[".js", ".py", ".md"]  // Filter by extensions
)

Analyze Project Context

analyze_project_context(
  include_code_analysis=true,    // Include complexity analysis
  focus_files=["specific_file.js"]  // Focus on specific files
)

Search Files

search_files(
  query="function myFunction",  // Search query
  file_types=[".js", ".ts"],   // File types to search
  is_regex=false,              // Use regex matching
  max_results=50               // Maximum results
)

Git Context

get_git_context(
  include_diff=true,     // Include working directory changes
  commit_count=10        // Number of recent commits
)

File Management Tools

Create Files

create_file(
  path="src/new-component.js",
  content="const MyComponent = () => { ... }",
  encoding="utf8",
  overwrite=false
)

Update Files

update_file(
  path="src/config.js",
  updates=[
    {
      search: "oldValue: 'old'",
      replace: "newValue: 'new'",
      regex: false,
      all: true
    }
  ],
  backup=true
)

Append to Files

append_to_file(
  path="README.md",
  content="## New Section\nContent here...",
  newline_before=true
)

Delete Files

delete_file(
  path="old-file.js",
  backup=true  // Creates .deleted backup
)

Rename/Move Files

rename_file(
  old_path="old-name.js",
  new_path="new-name.js",
  overwrite=false
)

Create Directories

create_directory(
  path="src/components/new-feature",
  recursive=true
)

Batch Operations

Execute multiple operations atomically:

batch_file_operations(
  operations=[
    {
      operation: "create",
      params: {
        path: "src/component.js",
        content: "export default () => {}"
      }
    },
    {
      operation: "update",
      params: {
        path: "src/index.js",
        updates: [...]
      }
    }
  ],
  rollback_on_error=true
)

📚 Documentation

Project Type Detection

The server automatically detects project types based on configuration files:

• Node.js/JavaScript: package.json
• Python: requirements.txt
• Rust: Cargo.toml
• Go: go.mod
• Java: pom.xml, build.gradle
• PHP: composer.json
• Ruby: Gemfile
• Docker: Dockerfile, docker-compose.yml
• And more...

File Priority Detection

The server identifies important files automatically:

• Configuration files (package.json, config.js, etc.)
• Entry points (index.js, main.py, app.js)
• Documentation (README.md, docs)
• Docker files
• Environment files (.env)

Resource Exposure

Important files are automatically exposed as MCP resources, enabling easy access for AI assistants without explicit file reading requests.

Error Handling and Safety Features

• Backup Creation: Automatically create backups for destructive operations.
• Collision Detection: Prevent accidental overwrites.
• Transaction Rollback: Fully roll back batch operations on error.
• Path Validation: Ensure operations stay within the working directory bounds.
• Detailed Error Messages: Provide comprehensive error reporting for debugging.

🔧 Technical Details

API Reference

Core Tools

File Operations

Configuration Options

Server Configuration

• Working Directory: Set via set_working_directory or during initialization.
• File Type Filters: Configure file extension filtering.
• Search Limits: Configure maximum search results.
• Backup Policies: Optionally create backups for destructive operations.

MCP Client Configuration

Configure the server in your MCP client with appropriate command and arguments. The server communicates via stdio and requires no additional network configuration.

Development and Contribution

Project Structure

enhanced-directory-context-mcp/
├── server.js                 # Main MCP server implementation
├── package.json             # Node.js package configuration
├── mcp-json-config.json     # Example MCP client configuration
└── README.md               # This documentation

Dependencies

• @modelcontextprotocol/sdk: Core MCP functionality
• Node.js built-in modules: fs, path, child_process

Running in Development Mode

npm run dev

This starts the server with Node.js inspector enabled for debugging.

📄 License

MIT License - See package.json for details.

Support and Issues

For issues, feature requests, or contributions, please refer to the repository's issue tracker.

⚠️ Important Note

This MCP server provides powerful file system access. Ensure you trust the AI assistant and understand the operations being performed, especially destructive operations like file deletion or modification.