Deno MCP

🚀 @cong/mcp-deno

@cong/mcp-deno 是一個安全的 MCP（模型上下文協議）服務器，它允許像 Claude 這樣的 AI 助手通過 Deno 執行 TypeScript 和 JavaScript 代碼，為 AI 與代碼執行的結合提供了安全可靠的解決方案。

✨ 主要特性

• 🔒 安全的代碼執行：利用 Deno 的權限系統，確保代碼執行的安全性。
• 🚀 支持 TypeScript 和 JavaScript：具備完整的 Deno 運行時環境。
• 🛡️ 可配置的權限：在服務器啟動時即可設置權限。
• 🔌 符合 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 Inspector 進行調試

若要調試和測試 MCP 服務器，可使用 MCP Inspector：

# 安裝 MCP Inspector
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 許可證。

🤝 貢獻指南

歡迎大家貢獻代碼！你可以提交 issue 或者發起 pull request。