JavaScript模型上下文协议服务器

JavaScript MCP Server (js-mcp) 是一个模型上下文协议服务器,允许AI助手在具有状态的REPL会话中执行JavaScript代码。它提供了一次性JavaScript执行、状态保持的REPL会话、文件系统操作和包管理等功能。适用于需要执行JavaScript代码、管理文件或进行包管理的AI助手场景。

  • by yannbam
  • 更新于
在 GitHub 查看 yannbam/js-mcp

使用说明

基本能力

产品定位

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