Back to Home
canstralian icon

parrot_mcp_server

by canstralian

Overview

Provides a robust Bash script library and a minimal MCP server stub for Raspberry Pi 5, focused on system automation, maintenance, and interaction with AI agents.

Installation

Run Command
./rpi-scripts/start_mcp_server.sh

Environment Variables

  • PARROT_BASE_DIR
  • PARROT_SCRIPT_DIR
  • PARROT_LOG_DIR
  • PARROT_IPC_DIR
  • PARROT_PID_FILE
  • PARROT_SERVER_LOG
  • PARROT_CLI_LOG
  • PARROT_HEALTH_LOG
  • PARROT_WORKFLOW_LOG
  • PARROT_LOG_MAX_SIZE
  • PARROT_LOG_MAX_AGE
  • PARROT_LOG_ROTATION_COUNT
  • PARROT_LOG_LEVEL
  • PARROT_MCP_INPUT
  • PARROT_MCP_BAD
  • PARROT_MCP_PORT
  • PARROT_MCP_HOST
  • PARROT_MCP_TLS
  • PARROT_DISK_THRESHOLD
  • PARROT_LOAD_THRESHOLD
  • PARROT_MEM_THRESHOLD
  • PARROT_ALERT_EMAIL
  • PARROT_NOTIFY_EMAIL
  • PARROT_EMAIL_PREFIX
  • PARROT_AUTO_UPDATE
  • PARROT_AUTO_CLEAN
  • PARROT_CACHE_MAX_AGE
  • PARROT_BACKUP_DIR
  • PARROT_BACKUP_RETENTION
  • PARROT_RUN_AS_USER
  • PARROT_STRICT_PERMS
  • PARROT_VALIDATION_LEVEL
  • PARROT_MAX_INPUT_SIZE
  • PARROT_RETRY_COUNT
  • PARROT_RETRY_DELAY
  • PARROT_COMMAND_TIMEOUT
  • PARROT_DEBUG
  • PARROT_DRY_RUN
  • PARROT_TRACE
  • PARROT_RATE_LIMIT
  • PARROT_RATE_LIMIT_WINDOW
  • PARROT_RATE_LIMIT_FILE
  • PARROT_CRON_DAILY
  • PARROT_CRON_BACKUP
  • PARROT_CRON_HEALTH
  • PATH

Security Notes

The server has critical security vulnerabilities as documented by the project itself: 1. Insecure Inter-Process Communication (IPC) via world-readable files in /tmp, prone to race conditions and symlink attacks. The 'start_mcp_server.sh' still uses this vulnerable default. 2. No Authentication or Authorization for the MCP server, allowing any local process to send commands. 3. Insecure Cron Setup using predictable temporary files. While significant progress has been made on input validation functions in 'common_config.sh', not all scripts fully utilize them or inherent risks remain due to the fundamental architecture of the server stub.

Similar Servers

Stats

Interest Score30
Security Score3
Cost ClassLow
Avg Tokens100
Stars1
Forks0
Last Update2026-01-09

Tags

Raspberry PiBashCLISystem AutomationEdge Computing