Back to Home
andreswebs icon

mcbox

Verified Safe

by andreswebs

Overview

Provides a lightweight and portable pluggable MCP (Model Context Protocol) server for AI agents to execute local tools via stdio transport.

Installation

Run Command
mcbox

Environment Variables

  • MCBOX_DATA_HOME
  • MCBOX_CONFIG_HOME
  • MCBOX_SERVER_CONFIG_FILE
  • MCBOX_TOOLS_CONFIG_FILE
  • MCBOX_TOOLS_LIB_FILE
  • MCBOX_CORE_LIB_FILE
  • MCBOX_TOOLS_FUNCTION_NAME_PREFIX
  • MCBOX_LOG_LEVEL
  • OTEL_LOG_LEVEL
  • XDG_CONFIG_HOME
  • XDG_DATA_HOME

Security Notes

The server design emphasizes security through stdio transport and JSON schema validation of tool inputs. It uses `jq` for safe parsing of JSON arguments, mitigating common shell injection risks for core operations. However, the overall security critically depends on the custom tool implementations (`tools.bash`) provided by the user. If user-defined tools do not properly validate and sanitize their inputs, especially when calling external commands (e.g., `sqlite3` without sanitizing the query), vulnerabilities could be introduced. The documentation explicitly highlights input validation as a best practice for tool developers.

Similar Servers

Stats

Interest Score30
Security Score8
Cost ClassMedium
Avg Tokens750
Stars1
Forks0
Last Update2025-12-15

Tags

MCP ServerBashjqAI ToolsLocal Execution