JavaScript代码解释器

一个提供JavaScript代码执行能力的MCP服务器,允许AI助手在安全的Node.js环境中执行代码并返回结果。

  • by qforge-dev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 qforge-dev/qcode

使用说明

QCode-JavaScript代码解释器MCP服务器

提供JavaScript代码执行功能的模型上下文协议(MCP)服务器。此服务器允许AI助手在安全的Node.js环境中执行JavaScript代码并返回结果。

特性

  • JavaScript执行:在隔离的Node.js环境中执行JavaScript代码
  • 超时保护:可配置的执行超时,以防止代码失控
  • 错误处理:包含执行详细信息的全面错误报告
  • 临时文件管理:自动清理临时文件
  • 执行指标:返回性能监控的执行时间

安装

npm install -g @qforge/qcode

用法

使用克劳德桌面

添加到您的Claude Desktop配置文件中:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "qcode": {
      "command": "qcode"
    }
  }
}

与其他MCP客户端

服务器通过stdio通信,可以与任何兼容MCP的客户端集成。

可用工具

execute_javascript

在Node.js环境中执行JavaScript代码。

参数:

  • code (string,必填):要执行的JavaScript代码
  • timeout (数字,可选):超时时间(毫秒)(默认值:30000)

退货:

  • success (boolean):执行是否成功
  • output (string):代码执行的标准输出
  • error (string):执行失败时出现错误消息
  • executionTime (number):执行所用的时间(毫秒)

例子:

console.log("Hello, World!");
console.log("Current time:", new Date().toISOString());

const numbers = [1, 2, 3, 4, 5];
const sum = numbers.reduce((a, b) => a + b, 0);
console.log("Sum:", sum);

安全考虑

  • 代码在范围有限的临时目录中执行
  • 每次执行都会创建一个新的隔离进程
  • 自动超时保护防止无限循环
  • 临时文件在执行后会自动清理

发展

从源头构建

git clone <repository-url>
cd qcode
npm install
npm run build

在发展中奔跑

npm run watch

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

贡献

欢迎投稿!请随时提交拉取请求。