MCP Deno Sandbox

🚀 Deno Sandbox MCP Server

A platform that uses the Deno runtime environment to run and manage code. It isolates code execution through permission configuration to ensure security.

🚀 Quick Start

The Deno Sandbox MCP Server is a platform that utilizes the Deno runtime environment for code execution and management. It enhances security by isolating code execution through permission configuration.

✨ Features

• Runs and manages code using the Deno runtime environment.
• Isolates code execution via permission configuration for enhanced security.

📦 Installation

# Clone the repository
git clone https://github.com/bewt85/mcp-deno-sandbox.git
cd mcp-deno-sandbox

# Install dependencies
npm install

📚 Documentation

Configuration Check

npm run checks

Code Fix

npm run fix

💻 Usage Examples

Basic Usage

Use the MCP monitor for testing:

npx @modelcontextprotocol/inspector ./node_modules/.bin/ts-node src/index.ts

Specific Use Cases

1. Basic Arithmetic Operations

console.log(1 + 2);

2. Network Access (Requires --allow-net permission)

fetch('https://icanhazip.com').then(response => response.text()).then(ip => console.log(`Your IP address is: ${ip.trim()}`));

3. File System Access (Requires --allow-read permission)

const text = Deno.readTextFileSync('/path/to/file.txt');
console.log(text);

⚠️ Important Note

• Avoid Broad Permissions: Do not grant permissions such as FFI or execution, as these can undermine the security of the sandbox.
• File Access Control: Configure read and write permissions carefully, especially for sensitive dotfiles (e.g., files containing credentials).
• Network Permissions: If enabling network access, ensure a trusted environment.

🐛 Known Issues

Python-related Issues

• File Writing Issue: Currently, you cannot use open(PATH, 'w') to write files. The solution is to use import js; js.fs.writeFileSync(PATH, CONTENT).
• Directory Mounting Issue: By default, the home directory and /tmp are mounted. If you need other directories, specify them explicitly.

👥 Contribution Guidelines

Due to limited time, we are unable to participate in most feature requests or contributions. We recommend that interested developers fork the repository and develop independently.

🚀 Release Process

1. Update the version number in package.json to X.Y.Z.
2. Commit the changes.
3. Create a tag vX.Y.Z on GitHub.
4. Wait for automatic deployment to NPM.

📄 License

This project is licensed under the MIT License.