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)

Install dependencies:
cd /home/connor-boetig/proj/mcp2 npm install
Build the project:
npm run build
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
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:

npm start

Watch mode for development:

npm run watch

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:

// Read a file await use_mcp_tool({ server_name: "unrestricted-dev", tool_name: "fs_read_file", arguments: { path: "/path/to/file.txt" } }); // Install a package await use_mcp_tool({ server_name: "unrestricted-dev", tool_name: "shell_execute", arguments: { command: "apt install -y nodejs", sudo: true } }); // List directory await use_mcp_tool({ server_name: "unrestricted-dev", tool_name: "fs_list_directory", arguments: { path: "/home/user/projects", recursive: true, showHidden: false } });

Project Structure

mcp2/ ├── package.json # Dependencies and scripts ├── tsconfig.json # TypeScript config ├── src/ │ ├── index.ts # Main server entry point │ └── tools/ │ ├── filesystem.ts # ✅ Fully implemented │ ├── shell.ts # ✅ Fully implemented │ ├── docker.ts # 🚧 Stub │ ├── mongodb.ts # 🚧 Stub │ ├── git.ts # 🚧 Stub │ ├── process.ts # 🚧 Stub │ └── network.ts # 🚧 Stub └── build/ # Compiled output