MCP Deno Sandbox

🚀 Deno 沙盒 MCP 服務器

Deno 沙盒 MCP 服務器是一個藉助 Deno 運行時環境來運行和管理代碼的平臺。它通過配置權限對代碼執行進行隔離，以此保障安全性。

🚀 快速開始

Deno 沙盒 MCP 服務器是一個使用 Deno 運行時環境來運行和管理代碼的平臺。它通過配置權限來隔離代碼執行，確保安全性。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/bewt85/mcp-deno-sandbox.git
cd mcp-deno-sandbox

# 安裝依賴項
npm install

📚 詳細文檔

配置檢查

npm run checks

代碼修復

npm run fix

💻 使用示例

基礎用法

使用 MCP 監視器測試：

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

高級用法

示例用例

1. 基本算術運算：

console.log(1 + 2);

2. 網絡訪問（需配置 --allow-net 權限）：

fetch('https://icanhazip.com').then(response => response.text()).then(ip => console.log(`您的 IP 地址是: ${ip.trim()}`));

3. 文件系統訪問（需配置 --allow-read 權限）：

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

⚠️ 安全注意事項

⚠️ 重要提示

• 避免廣泛權限：不要授予如 FFI 或執行權限，這些會削弱沙盒的安全性。
• 文件訪問控制：謹慎配置讀寫權限，特別是對敏感的 dotfiles（如包含憑證的文件）。
• 網絡權限：若啟用網絡訪問，請確保受信任的環境。

❗ 已知問題

Python 相關問題

• 文件寫入問題：目前無法使用 open(PATH, 'w') 寫入文件。解決方案是使用 import js; js.fs.writeFileSync(PATH, CONTENT)。
• 目錄掛載問題：默認掛載家目錄和 /tmp，如需其他目錄，請明確指定。

🤝 貢獻說明

💡 使用建議

由於時間有限，無法參與大部分功能請求或貢獻。建議有意向的開發者自行 fork 倉庫進行開發。

🚀 發版流程

1. 更新 package.json 中的版本號為 X.Y.Z。
2. 提交更改。
3. 在 GitHub 上創建標籤 vX.Y.Z。
4. 等待自動部署到 NPM。

📄 許可證

本項目採用 MIT 許可證。