البدء السريع

Clone the repository, copy .env.example, configure a public HTTPS URL, OAuth PIN, and JWT secret, then start Docker Compose.

git clone https://github.com/fwerkor/local-shell-mcp.git
cd local-shell-mcp
cp .env.example .env
mkdir -p workspaces/default
docker compose up -d
curl -i http://127.0.0.1:8765/healthz

LOCAL_SHELL_MCP_PUBLIC_BASE_URL=https://your-public-host.example.com
LOCAL_SHELL_MCP_AUTH_MODE=oauth
LOCAL_SHELL_MCP_OAUTH_ADMIN_PIN=change-me-long-random-pin
LOCAL_SHELL_MCP_OAUTH_JWT_SECRET=change-me-64-hex-random-secret

في النشر العام فعّل OAuth ولا تربط Docker socket أو جذر المضيف أو بيانات اعتماد طويلة الأمد.