MCP File Forge

Provides secure file operations and project scaffolding via MCP with sandboxing and template-based scaffolding.

javascript

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-tool-shop-org-mcp-file-forge": {
      "command": "node",
      "args": [
        "path/to/mcp-file-forge/build/index.js"
      ],
      "env": {
        "MCP_FILE_FORGE_LOG_LEVEL": "info",
        "MCP_FILE_FORGE_READ_ONLY": "false",
        "MCP_FILE_FORGE_ALLOWED_PATHS": "C:/Projects,C:/Users/you/Documents",
        "MCP_FILE_FORGE_MAX_FILE_SIZE": "104857600"
      }
    }
  }
}

MCP File Forge enables secure file operations and project scaffolding through a model-context protocol server. You can perform sandboxed read/write actions, search and manage files, and scaffold projects from templates, all with Windows-friendly paths and configurable security.

How to use

You connect to the MCP File Forge server from your MCP client to perform file operations, scaffolding, and searches. You have two practical run modes: a local, node-based server you start directly, or a CLI-driven runtime you invoke with a single command. Use the local server when you want to run the MCP alongside your project tooling, or use the standalone runtime when you prefer quick, on-demand usage without installation.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Option 1: Install as a local MCP server (requires running a Node process) — from your project directory run:

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

After installation, you typically run the server using the built output. For example, you might start the server with a standard node command that points to the build index.

Option 2: Run without permanent installation using the standalone runtime, which loads the MCP server on demand:

npx @mcp-tool-shop/file-forge

Additional setup and usage notes

You can also integrate the server into a desktop client by providing a configuration that launches the MCP server as a background process and exposes the allowed paths for secure operations.

Configuration and security

You control access and behavior through environment variables and a local configuration file. The server supports sandboxed paths, read-only mode, and maximum file size restrictions to protect your system from unintended or excessive operations.

Troubleshooting and tips

If you encounter permission or path issues, verify that the configured allowed paths truly reflect where you intend to read or write files. Check that the server process has permission to access those directories and that any read-only mode is not blocking needed write operations.

Notes on usage patterns

Common workflows include creating a project scaffold from a template, reading and validating file contents, performing batch reads, and searching across files with glob patterns or regex. Use these patterns to automate project bootstrapping and safe file management within your defined sandbox.

Configuration overview

The server is configurable via environment variables and a local configuration file. Environment variables allow you to set allowed paths, enable read-only mode, cap file size, and control logging. The configuration file provides sandbox rules for allowed and denied paths and maximum file size as a security scaffold.

Development and testing

If you are developing or testing locally, install dependencies, build the project, run in development mode to watch for changes, and execute tests to verify file operations, scaffolding, and search features.

Licensing and authorship

MIT license. Authored by the MCP tool shop team.

Security hints

Path sandboxing restricts operations to approved directories. Symlink following is disabled by default. Read-only mode can be enabled for safety, and size limits prevent memory exhaustion from large reads or writes.

Available tools

read_file

Read file contents with options for encoding and specific line ranges.

read_directory

List directory contents with metadata.

read_multiple

Batch read multiple files in a single operation.

write_file

Write or overwrite file contents.

create_directory

Create directories as needed for file operations.

copy_file

Copy files or directories to a new location.

move_file

Move or rename files or directories.

delete_file

Delete files or directories.

glob_search

Find files matching glob patterns across the sandbox.

grep_search

Search file contents using regular expressions.

file_stat

Get statistics and metadata for a given path.

file_exists

Check if a path exists in the sandbox.

scaffold_project

Create a project from a template with variable substitution.

list_templates

List available templates for scaffolding.

Built by

VeilStrat

AI signals for GTM teams