MCP File Forge

A Model Context Protocol (MCP) server for secure file operations and project scaffolding.

Features

• Secure File Operations: Read, write, copy, move, and delete files with sandboxed access controls

• Project Scaffolding: Create projects from templates with variable substitution

• Windows-First: Optimized for Windows paths, permissions, and conventions

• Search Capabilities: Glob patterns and regex content search

• Configurable Security: Define allowed paths, size limits, and read-only modes

Installation

npm install @mcp-tool-shop/file-forge

Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "file-forge": {
      "command": "node",
      "args": ["path/to/mcp-file-forge/build/index.js"],
      "env": {
        "MCP_FILE_FORGE_ALLOWED_PATHS": "C:/Projects,C:/Users/you/Documents"
      }
    }
  }
}

Standalone

npx @mcp-tool-shop/file-forge

Available Tools

File Reading

• read_file - Read file contents with encoding and line range options

• read_directory - List directory contents with metadata

• read_multiple - Batch read multiple files

File Writing

• write_file - Write or overwrite file contents

• create_directory - Create directories

• copy_file - Copy files or directories

• move_file - Move or rename files

• delete_file - Delete files or directories

Search

• glob_search - Find files matching glob patterns

• grep_search - Search file contents with regex

Metadata

• file_stat - Get file statistics

• file_exists - Check if path exists

Scaffolding

• scaffold_project - Create project from template

• list_templates - List available templates

Configuration

Environment Variables

Config File

Create mcp-file-forge.json in the working directory:

{
  "sandbox": {
    "allowed_paths": ["./projects"],
    "denied_paths": ["**/secrets/**"],
    "max_file_size": 52428800
  }
}

Security

• Path sandboxing restricts operations to allowed directories

• Symlink following is disabled by default

• Read-only mode available for safe browsing

• Size limits prevent memory exhaustion

Development

# Install dependencies
npm install

# Build
npm run build

# Development mode (watch)
npm run dev

# Run tests
npm test

License

MIT

Author

mcp-tool-shop