Fresh JavaScript

🚀 JavaScript MCP 服务器

这是一个用于模型上下文协议（MCP）的 JavaScript 执行服务器，它能让 AI 模型借助 MCP 工具调用并运行 JavaScript 代码，为 AI 与 JavaScript 代码的交互提供了便利。

🚀 快速开始

本服务器允许 AI 模型通过 MCP 工具调用运行 JavaScript 代码，支持多种运行模式和丰富的工具。

✨ 主要特性

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

📦 安装指南

# 克隆仓库
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 使用模型上下文协议进行通信。
2. 交互模式：提供 REPL 接口供用户直接交互。
3. 管道模式：使用命名管道与外部进程通信。

有关这些模式的详细说明，请参阅 examples 目录。

可用工具

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

📚 详细文档

开发

# 以开发模式运行，带热重载
npm run dev

# 检查代码
npm run lint

# 运行测试
npm test

🔧 技术细节

JavaScript MCP 服务器遵循分层架构：

1. MCP 协议层：处理客户端通信。
2. JavaScript 执行层：在隔离环境中执行代码。
3. 资源管理层：管理包和 TypeScript。
4. 会话管理层：维护带状态持久化的 REPL 会话。

📄 许可证

MIT