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。