Unrestricted Development MCP Server

# 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:** ```bash cd /home/connor-boetig/proj/mcp2 npm install ``` 2. **Build the project:** ```bash npm run build ``` 3. **Add to Claude Code:** Use the Claude Code CLI to add the MCP server: ```bash claude mcp add-json unrestricted-dev '{"command":"node","args":["/home/connor-boetig/proj/mcp2/build/index.js"],"cwd":"/"}' ``` Verify it's configured: ```bash 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: ```bash npm start ``` Watch mode for development: ```bash 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: ```javascript // 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 ``` ## Development Watch mode for development: ```bash npm run watch ``` ## License MIT