Fresh JavaScript

🚀 JavaScript MCP 服務器

這是一個用於模型上下文協議（MCP）的 JavaScript 執行服務器，它允許 AI 模型藉助 MCP 工具調用並運行 JavaScript 代碼，為 AI 與 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 會話。

🔧 技術細節

JavaScript MCP 服務器遵循分層架構：

1. MCP 協議層：處理客戶端通信。
2. JavaScript 執行層：在隔離環境中執行代碼。
3. 資源管理層：管理包和 TypeScript。
4. 會話管理層：維護帶狀態持久化的 REPL 會話。

📄 許可證

本項目採用 MIT 許可證。