JavaScript MCP Server (js-mcp)

基本能力

产品定位

JavaScript MCP Server (js-mcp) 是一个用于执行JavaScript代码的MCP服务器，支持有状态的REPL会话和文件系统操作，适用于AI助手和开发工具。

核心功能

• 一次性JavaScript执行：在Node.js中直接执行JavaScript代码
• 有状态REPL会话：跨多次执行维护变量和上下文
• 文件系统操作：读取、写入和操作文件
• 包管理：导入模块和管理npm包
• 高级功能：安全沙箱执行、异步代码支持、错误处理、会话管理

适用场景

• AI助手需要动态执行JavaScript代码
• 开发工具需要支持有状态的REPL会话
• 需要安全地执行用户提供的JavaScript代码

工具列表

• 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

许可证

该项目遵循 MIT 开源许可条款。