What is MCP-ShellJS?

MCP-ShellJS is a secure bridge between Model Context Protocol (MCP) and ShellJS, enabling LLMs to execute shell commands in a controlled environment.

What are the main features of MCP-ShellJS?

Key features include simplified security with read-only mode by default, optional read-write and exec permissions, schema-based validation, full ShellJS functionality, TypeScript implementation, and a simple API for LLM integration.

How do I install MCP-ShellJS?

Install MCP-ShellJS by cloning the repository, installing dependencies, and building the project using npm commands.

What security measures does MCP-ShellJS implement?

MCP-ShellJS implements security through read-only mode, optional read-write mode, and controlled exec command permissions. It also uses schema-based validation.

Why should I use MCP-ShellJS?

Use MCP-ShellJS for efficient exploration, text processing, safe automation, and powerful pipelines with controlled risk for AI developers.

What is the directory resource in MCP-ShellJS?

The directory resource provides directory listing with filtering capabilities using include, exclude, and honor_gitignore parameters.

What is the file resource in MCP-ShellJS?

The file resource provides file contents with options for viewing specific portions using lines, start, and end parameters.

What are the read-only tools available in MCP-ShellJS?

Read-only tools include cat, grep, find, ls, which, pwd, test, head, tail, sort, and uniq.

What are the read-write tools available in MCP-ShellJS?

Read-write tools include mkdir, touch, cp, mv, rm, and sed.

What is the special permission tool in MCP-ShellJS?

The special permission tool is exec, which requires explicit allowExec: true configuration for use.