Skip to main content
Glama
unfallenwill

nodejs-repl-mcp

by unfallenwill

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NODEJS_REPL_SESSIONS_DIRNoDirectory where per-session workspaces are stored. Defaults to ~/.nodejs-repl/sessions.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
create_sessionA

Create a named, persistent Node.js REPL session. Each session runs in its own child process with an isolated context: variables, let/const declarations, required modules and top-level await state persist across exec calls until the session is removed.

execA

Evaluate JavaScript in a named REPL session with full node:repl semantics. Syntax-incomplete input is buffered and continues on the next exec (multi-line). Returns the inspected result, captured console output, and any error. State persists between execs.

historyA

Return the evaluation history of a session (inputs, outputs, errors, captured console) — useful for reviewing what state was built up.

list_sessionsA

List all REPL sessions with pid, workspace and liveness.

remove_sessionA

Stop and remove a session (kills its worker process). The session workspace directory is kept, so installed dependencies and written files survive.

install_packagesA

Run npm install in the session workspace so subsequent exec calls can require/import the packages. Installs into that session only.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.3/5.0

Scored across 6 tools

Disambiguation5/5

Each tool maps to a distinct operation: session lifecycle (create/list/remove), code execution, history retrieval, and package installation. There is no meaningful overlap or risk of selecting the wrong tool.

Naming Consistency4/5

Most tools follow a clear verb_noun pattern (create_session, list_sessions, remove_session, install_packages), but exec and history are terse single-word names that break the pattern. Overall still readable and predictable.

Tool Count5/5

Six tools is a well-scoped set for managing persistent Node.js REPL sessions. Each tool serves a clear need without redundancy or bloat.

Completeness5/5

The surface covers the full lifecycle: create a session, execute code in it, inspect history, install dependencies, list sessions, and remove sessions. No obvious dead ends or missing critical operations.

Maintenance

ActivityMaintained
ResponsivenessNo issues