Back to Home
ShayYeffet icon

mcp_server

Verified Safe

by ShayYeffet

Overview

A secure, sandboxed server enabling LLMs to interact with a filesystem and execute allowed commands within a designated workspace for project management and development tasks.

Installation

Run Command
node dist/index.js

Environment Variables

  • MCP_WORKSPACE_ROOT
  • MCP_ALLOWED_COMMANDS
  • MCP_READ_ONLY
  • MCP_LOG_LEVEL
  • MCP_COMMAND_TIMEOUT

Security Notes

The project prioritizes security, implementing robust sandboxing for all file operations via `resolveSafePath`, which diligently handles `.` `..` traversals, absolute paths, and crucially, symbolic link resolution to prevent workspace escapes. Command execution (`runCommand`) uses `child_process.spawn` with `shell: false` and arguments passed as arrays, effectively mitigating command injection. Commands are strictly controlled via a configurable allowlist (`MCP_ALLOWED_COMMANDS`), ensuring only explicitly permitted binaries can run. An optional read-only mode prevents all write, delete, and creation operations. Atomic file writes (`writeFileAtomic`) prevent partial file corruption. Error handling is structured to avoid exposing sensitive system details, and configuration is managed through environment variables without hardcoded secrets. The server uses `stdio` for communication, limiting its direct network exposure.

Similar Servers

Stats

Interest Score0
Security Score10
Cost ClassMedium
Avg Tokens3000
Stars0
Forks0
Last Update2025-12-06

Tags

LLMWorkspaceFilesystemSandboxSecurityNode.jsTypeScript