MCP Repl

🚀 Direct Node.js REPL Executor

A streamlined environment for direct Node.js execution, enabling seamless code execution.

🚀 Quick Start

Configuration

For Cursor, update your .cursor/mcp.json configuration:

{
  "mcpServers": {
    "mcp-repl": {
      "command": "node",
      "args": [
        "path/to/direct-node-executor.js", "path/to/your/project"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": ["execute"]
    }
  }
}

✨ Features

• 🚀 Direct Node.js Execution: Run code directly in Node.js without sandbox isolation.
• 📦 Full Module Support: Seamlessly support ESM and CommonJS modules.
• ⏱️ Real-time Feedback: Get immediate results of code execution.
• 🔍 Enhanced Debugging: Clean output and excellent error handling.
• 🧠 Simple Architecture: Simplified implementation with low complexity.
• 🔄 File System Access: Fully access the file system for real-world testing.

🧙♂️ Simplified JavaScript Execution Environment

A streamlined direct Node.js execution environment that supports seamless code execution and offers the following features:

• ESM Modules - Native import/export syntax.
• Dynamic Imports - Fully support await import().
• CommonJS Compatibility - Use require() via createRequire.
• Native Node.js API Access - Directly access all Node.js features.

🔧 Technical Details

This implementation:

1. Creates a temporary .mjs file for each execution.
2. Runs the code in a separate process using Node.js.
3. Captures all console outputs and execution results.
4. Automatically cleans up temporary files.
5. Returns standardized results to the MCP client.

💻 Usage Examples

Basic Usage

// Dynamic imports
const fs = await import('fs/promises');
const path = await import('path');

// Read a file
const content = await fs.readFile('package.json', 'utf8');
console.log(JSON.parse(content));

// Use path utilities
console.log(path.join('folder', 'file.txt'));

📄 License

This project is licensed under the MIT license.