基本能力
产品定位
JavaScript MCP Server (js-mcp) 是一个允许AI助手在状态保持的REPL会话中执行JavaScript代码的服务器。
核心功能
- 一次性JavaScript执行：直接在Node.js中执行JavaScript代码
- 状态保持的REPL会话：在多次执行中保持变量和上下文
- 文件系统操作：读取、写入和操作文件
- 包管理：导入模块和管理npm包
高级功能
- 安全的沙箱执行
- 异步代码支持
- 带格式化堆栈跟踪的错误处理
- 带自动清理的会话管理
适用场景
- AI助手需要执行JavaScript代码
- 需要保持状态的代码执行环境
- 文件系统操作需求
- npm包管理需求
可用工具
JavaScript执行
- execute_javascript：在基本沙箱中运行JavaScript代码
- execute_javascript_with_modules：运行带模块导入的JavaScript
- execute_javascript_async：运行异步JavaScript代码
REPL会话
- repl_create_session：创建新的REPL会话
- repl_execute：在REPL会话中执行代码
- repl_get_context：获取会话中的变量值
- repl_delete_session：删除会话
- repl_list_sessions：列出所有活动会话
文件操作
- file_read：读取文件内容
- file_write：将内容写入文件
- file_list：列出目录中的文件
- file_delete：删除文件或目录
- file_exists：检查文件是否存在
包管理
- package_check：检查模块是否可用
- package_install：安装npm包
- package_list：列出已安装的包
使用教程
使用依赖
确保已安装Node.js和npm。
安装教程
# 克隆仓库
git clone https://github.com/yourusername/js-mcp.git
cd js-mcp
# 安装依赖
npm install
# 构建项目
npm run build调试方式
使用stdio传输运行（用于Claude Desktop）
npm start
# 或
node dist/index.js --stdio使用HTTP传输运行
node dist/index.js --http
# 默认端口为3000，或使用PORT环境变量指定
PORT=3456 node dist/index.js --http开发模式
# 以开发模式启动
npm run dev
# 运行测试
npm test
# 代码检查
npm run lint
# 代码格式化
npm run format