MCP Deno Sandbox

🚀 Deno 沙盒 MCP サーバ

Deno 沙盒 MCP サーバは、Deno ランタイム環境を使用してコードを実行および管理するプラットフォームです。権限を設定することでコードの実行を分離し、安全性を確保します。

🚀 クイックスタート

Deno 沙盒 MCP サーバを使用するための基本的な手順を説明します。

📦 インストール

以下の手順に従って、Deno 沙盒 MCP サーバをインストールします。

# リポジトリをクローンする
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

💻 使用例

基本的な使用法

以下は、基本的な算術演算の例です。

console.log(1 + 2);

高度な使用法

ネットワークアクセス

ネットワークアクセスを行うには、--allow-net 権限を設定する必要があります。

fetch('https://icanhazip.com').then(response => response.text()).then(ip => console.log(`あなたの IP アドレスは: ${ip.trim()}`));

ファイルシステムアクセス

ファイルシステムアクセスを行うには、--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 がマウントされます。他のディレクトリを使用する場合は、明示的に指定する必要があります。

🤝 貢献について

時間的な制約のため、ほとんどの機能要求や貢献には対応できません。有志の開発者は、リポジトリをフォークして独自に開発することをおすすめします。

🚀 リリースプロセス

1. package.json のバージョン番号を X.Y.Z に更新します。
2. 変更をコミットします。
3. GitHub でタグ vX.Y.Z を作成します。
4. NPM への自動デプロイを待ちます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。