Unrestricted Development MCP Server

A Model Context Protocol (MCP) server that provides AI with unrestricted access to your development environment.

Features

✅ Fully Implemented

1. Filesystem Tools (10 tools)

• fs_read_file - Read file contents

• fs_write_file - Write/overwrite files with auto-directory creation

• fs_append_file - Append to existing files

• fs_delete_file - Delete files

• fs_list_directory - List directory contents (recursive support)

• fs_create_directory - Create directories

• fs_delete_directory - Delete directories (recursive support)

• fs_get_file_info - Get file/directory metadata

• fs_move_file - Move/rename files

• fs_copy_file - Copy files

2. Shell Tools (2 tools)

• shell_execute - Execute any shell command with optional sudo

• shell_execute_streaming - Execute long-running commands with streaming output

🚧 Stubbed (TODO)

• Docker tools (container management)

• MongoDB tools (database operations)

• Git tools (version control)

• Process tools (process management)

• Network tools (HTTP, SSH, etc.)

Quick Setup (Ubuntu)

1. Install dependencies:

   cd /home/connor-boetig/proj/mcp2 npm install

2. Build the project:

   npm run build

3. Add to Claude Code:

   Use the Claude Code CLI to add the MCP server:

   claude mcp add-json unrestricted-dev '{"command":"node","args":["/home/connor-boetig/proj/mcp2/build/index.js"],"cwd":"/"}'

   Verify it's configured:

   claude mcp list

   You should see: unrestricted-dev: node /home/connor-boetig/proj/mcp2/build/index.js - ✓ Connected

4. Start using it! - The MCP tools are now available globally in every Claude Code conversation.

   Type /mcp to see your configured servers, or just start asking Claude to use the tools!

Development

Run manually for testing:

Watch mode for development:

Working Directory Behavior

Important Notes:

• The MCP server launches from the root directory (/) for full system access

• For file operations:

  • Absolute paths (e.g., /home/connor-boetig/projects/file.txt) always work

  • Relative paths (e.g., ./etc/nginx/nginx.conf or home/connor-boetig/file.txt) are relative to /

  • Both absolute and relative paths work seamlessly since we start from root

Security Warning

⚠️ This server grants UNRESTRICTED system access including:

• Full filesystem read/write/delete

• Shell command execution with sudo

• All privileges you have

Only use this on:

• Local development machines (NOT production)

• Trusted environments (VM, Docker, dedicated dev box)

• When you understand and accept the risks

Example Usage

Once connected, the AI can:

Project Structure

Development

Watch mode for development:

License

MIT