JavaScript MCP Server

JavaScript MCP Server

site icon
2025.03.27 0
TypeScriptJavaScript 执行REPL 会话TypeScript 支持NPM 集成开发效率
fresh-js-mcp 是一个基于 Model Context Protocol (MCP) 的 JavaScript 执行服务器,允许 AI 模型通过 MCP 工具调用运行 JavaScript 代码。它支持一次性脚本执行、状态保持的 REPL 会话、TypeScript 代码自动转译、动态导入和使用 npm 包等功能。
View on GitHub

Overview

基本能力

产品定位

fresh-js-mcp 是一个 JavaScript 执行服务器,专为通过 MCP 协议运行的 AI 模型设计,提供 JavaScript 代码执行环境。

核心功能

  • JavaScript 执行:支持一次性脚本执行模式
  • REPL 会话:支持跨多个交互的状态保持 REPL 会话
  • TypeScript 支持:支持 TypeScript 代码自动转译
  • NPM 集成:支持动态导入和使用 npm 包
  • 交互模式:提供直接命令行 REPL 接口
  • 命名管道接口:支持通过命名管道与外部进程通信

适用场景

  • AI 模型需要执行 JavaScript 代码的场景
  • 需要状态保持的交互式 JavaScript 执行环境
  • 需要动态加载和使用 npm 包的开发环境
  • 需要通过命名管道与外部进程通信的场景

工具列表

  • execute:运行 JavaScript 代码并返回结果
  • createSession:创建新的 REPL 会话
  • executeInSession:在现有会话中执行代码
  • listSessions:列出所有活跃的 REPL 会话
  • deleteSession:删除 REPL 会话

常见问题解答

无明确常见问题解答部分

使用教程

使用依赖

需要安装 Node.js 和 npm

安装教程

# 克隆仓库
git clone https://github.com/yannbam/fresh-js-mcp.git
cd fresh-js-mcp

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

# 以标准模式启动 MCP 服务器
npm start

# 以交互式 REPL 模式启动
node dist/index.js --interactive

# 以命名管道接口模式启动
node dist/index.js --pipe

# 查看所有选项
node dist/index.js --help

操作模式

  1. 标准 MCP 模式(默认):通过 stdio 使用 Model Context Protocol 通信
  2. 交互模式:提供 REPL 接口供用户直接交互
  3. 管道模式:使用命名管道与外部进程通信

许可证

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