MCPgee
MCPgee
MCPgeeMCPgee

NTS MCP File System

v1.0.0•File Systems•stable

Transactional File System server for Model Context Protocol (MCP). Enterprise-grade tools for AI agents: atomic edits, undo/redo, code navigation, refactoring, git integration. Docker ready.

ai-agentsantigravity-ide-mcpclaude-code-mcpcursor-ide-mcpdocker
Share:
8
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is NTS MCP File System?

NTS MCP File System is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to transactional file system server for model context protocol (mcp). enterprise-grade tools for ai agents: atomic edits, undo/redo, code navigation, refactoring, git integration. docker ready.

Transactional File System server for Model Context Protocol (MCP). Enterprise-grade tools for AI agents: atomic edits, undo/redo, code navigation, refactoring, git integration. Docker ready.

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Transactional File System server for Model Context Protocol

Use Cases

Transactional file operations
Git integration and code refactoring
Nefrols

Maintainer

LicenseApache-2.0
Languagejava
Versionv1.0.0
UpdatedApr 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx nts-mcp-fs

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use NTS MCP File System

NTS MCP FileSystem Server provides enterprise-grade, transactional file system operations for AI agents via the Model Context Protocol. It supports atomic edits with undo/redo, code navigation, refactoring, and Git integration. The server is available as a self-contained Java JAR or as a Docker image, making it suitable for both local development and containerized CI environments.

Prerequisites

  • Java 25 or later (for running the JAR directly)
  • Docker (optional, for the containerized deployment)
  • Gradle (for building from source)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
  • Git (for the built-in Git integration features)
1

Pull the Docker image or build from source

The fastest way to get started is pulling the pre-built Docker image. Alternatively, clone the repo and build the JAR with Gradle.

# Option A: Docker (recommended)
docker pull ghcr.io/nefrols/nts-mcp-fs:latest

# Option B: Build from source
git clone https://github.com/Nefrols/NTS_MCP_FS.git
cd NTS_MCP_FS
./gradlew shadowJar
2

Auto-integrate with supported MCP clients

If you built from source, run the auto-integrator to automatically configure Claude Code, Cursor, Gemini CLI, and other supported clients.

java -jar app/build/libs/app-all.jar --integrate
3

Configure Claude Desktop manually (Docker)

Add the Docker-based server to your Claude Desktop config, mounting your project directory inside the container.

4

Set environment variables for Docker mode

The NTS_DOCKER_ROOTS variable tells the server which paths inside the container are accessible roots. Set it to match your volume mount points.

# Example: single project
docker run -i --rm \
  -v /home/user/myproject:/mnt/project \
  -e NTS_DOCKER_ROOTS=/mnt/project \
  ghcr.io/nefrols/nts-mcp-fs:latest
5

Enable debug logging (optional)

Set the MCP_DEBUG environment variable to true for verbose output. Use MCP_LOG_FILE to write logs to a file, which is useful when your MCP client merges stderr and stdout.

NTS MCP File System Examples

Client configuration

Docker-based configuration for Claude Desktop supporting a single project directory.

{
  "mcpServers": {
    "NTS-FileSystem-MCP": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/home/user/myproject:/mnt/project",
        "-e", "NTS_DOCKER_ROOTS=/mnt/project",
        "ghcr.io/nefrols/nts-mcp-fs:latest"
      ]
    }
  }
}

Prompts to try

Use these prompts once the server is active in your MCP client.

- "Refactor the function calculateTotal in src/billing.js to extract a helper method"
- "Undo the last three file edits I made"
- "Show me all usages of the UserService class across the project"
- "Commit the current staged changes with the message 'fix: correct invoice total calculation'"

Troubleshooting NTS MCP File System

Server exits immediately when launched via Docker

Ensure you include the -i flag in your Docker run command. MCP servers communicate over stdio, and without interactive mode the container will exit as soon as the process starts.

NTS_DOCKER_ROOTS not recognized or paths not accessible

The value of NTS_DOCKER_ROOTS must exactly match the container-side paths in your -v volume mounts. For multiple projects, separate paths with a colon: NTS_DOCKER_ROOTS=/mnt/p1:/mnt/p2.

Java version error on direct JAR launch

NTS requires Java 25 or later. Run 'java -version' to check your current version. If below 25, install the latest JDK from adoptium.net or use the Docker image which bundles the correct JDK.

Frequently Asked Questions about NTS MCP File System

What is NTS MCP File System?

NTS MCP File System is a Model Context Protocol (MCP) server that transactional file system server for model context protocol (mcp). enterprise-grade tools for ai agents: atomic edits, undo/redo, code navigation, refactoring, git integration. docker ready. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install NTS MCP File System?

Follow the installation instructions on the NTS MCP File System GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with NTS MCP File System?

NTS MCP File System works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is NTS MCP File System free to use?

Yes, NTS MCP File System is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

NTS MCP File System Alternatives — Similar File Systems Servers

Looking for alternatives to NTS MCP File System? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "nts-mcp-fs": { "command": "npx", "args": ["-y", "nts-mcp-fs"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use NTS MCP File System?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides