Deno MCP

🚀 @cong/mcp-deno

このプロジェクトは、ClaudeのようなAIアシスタントがDenoを通じてTypeScriptとJavaScriptコードを実行できるようにする、安全なMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

@cong/mcp-denoは、AIアシスタントがDenoを介してTypeScriptとJavaScriptコードを安全に実行できるようにするMCPサーバーです。以下のセクションでは、インストール方法、使用方法、開発手順などを説明します。

✨ 主な機能

• 🔒 安全なコード実行：Denoのパーミッションシステムを使用して、コードを安全に実行します。
• 🚀 TypeScriptとJavaScriptのサポート：完全なDenoランタイムで、TypeScriptとJavaScriptをサポートします。
• 🛡️ 設定可能なパーミッション：サーバー起動時にパーミッションを設定できます。
• 🔌 MCP準拠：AIアシスタントとのシームレスな統合が可能です。
• ⚡ 高速で軽量：依存関係が少なく、高速で軽量なサーバーです。

📦 インストール

JSRからインストールするには、以下のコマンドを実行します。

deno add jsr:@cong/mcp-deno

または、直接実行することもできます。

deno run --allow-all jsr:@cong/mcp-deno

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定に追加するには、以下のように設定ファイルを編集します。

{
  "mcpServers": {
    "deno-executor": {
      "command": "deno",
      "args": [
        "run",
        "--allow-all",
        "jsr:@cong/mcp-deno"
      ]
    }
  }
}

パーミッション設定

実行するコードがアクセスできるリソースを制御するには、起動引数を変更します。

{
  "mcpServers": {
    "deno-executor": {
      "command": "deno", 
      "args": [
        "run",
        "--allow-net=example.com",
        "--allow-read=/tmp",
        "--allow-write=/tmp",
        "jsr:@cong/mcp-deno"
      ]
    }
  }
}

利用可能なパーミッションフラグは以下の通りです。

• --allow-net[=<allow-list>] - ネットワークアクセスを許可します。
• --allow-read[=<allow-list>] - ファイルシステムの読み取りアクセスを許可します。
• --allow-write[=<allow-list>] - ファイルシステムの書き込みアクセスを許可します。
• --allow-run[=<allow-list>] - サブプロセスの実行を許可します。
• --allow-env[=<allow-list>] - 環境変数へのアクセスを許可します。
• --allow-all - すべてのパーミッションを許可します（注意して使用してください）。

📚 ドキュメント

開発手順

# 依存関係のインストール
deno cache main.ts

# 開発モードで実行
deno task dev

# テストの実行
deno task test

# 型チェック
deno check main.ts

MCPインスペクターでのデバッグ

MCPサーバーのデバッグとテストには、MCPインスペクターを使用します。

# MCPインスペクターのインストール
npm install -g @modelcontextprotocol/inspector

# インスペクター付きでサーバーを実行
npx @modelcontextprotocol/inspector deno run --allow-all jsr:@cong/mcp-deno

# または、ローカルでテスト
npx @modelcontextprotocol/inspector deno run --allow-all main.ts

🔧 技術詳細

このMCPサーバーは、以下の方法でセキュリティを優先しています。

• サブプロセスの分離：コードは別々のDenoプロセスで実行されます。
• 明示的なパーミッション：実行されるコードには、許可されたパーミッションのみが与えられます。
• 永続的な状態のない設計：各実行は独立しています。
• パーミッションエラーの処理：パーミッションが不十分な場合には、明確なフィードバックが提供されます。

📄 ライセンス

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

コントリビューション

コントリビューションは大歓迎です！問題を報告するか、プルリクエストを送信してください。