{"id":"terminal-mcp-server","name":"terminal-mcp-server","homepage":"https://github.com/kanniganfan/terminal-mcp","repo_url":"https://github.com/kanniganfan/terminal-mcp","category":"devtools","subcategories":[],"tags":["mcp","terminal","agent-tools","concurrency","web-monitoring","fastapi","websockets","python"],"what_it_does":"An MCP server that provides AI agents with multi-session terminal execution, batch/concurrent command execution, workflow orchestration (DAG/sequences), and a local web UI for real-time terminal output and system stats.","use_cases":["Run multiple development/ops tasks in parallel (frontend/backend/DB) via a single MCP workflow","Collect system information concurrently (CPU/memory/disk/OS) and return aggregated outputs","Execute dependent build-test-deploy steps using a DAG/workflow model","Run retryable commands for transient failures (e.g., network/package installs)","Provide a web-based live monitoring view of terminal sessions using xterm.js"],"not_for":["Internet-facing remote shell access for untrusted users","Compliance-critical environments without further audit of command execution and logging","Use cases requiring strict resource isolation/tenant separation beyond local machine execution"],"best_when":"Used locally by trusted operators/agents to orchestrate shell commands with concurrency and monitoring on a developer workstation or CI-like environment.","avoid_when":"Avoid exposing the service to untrusted networks/users or using it in environments where arbitrary shell command execution cannot be tightly controlled.","alternatives":["MCP-compatible sandboxed execution services (if available in your environment)","Task runners/CI orchestration tools (e.g., GitHub Actions, Buildkite) for workflows","Local process managers / terminal automation scripts (custom tooling) without MCP"],"af_score":66.8,"security_score":21.8,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["pypi"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:42:24.452006+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"README does not describe any authentication/authorization mechanism for the MCP tools or the local web server. Tool access appears to be controlled implicitly by local IDE configuration."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided; package appears to be an open-source tool distributed via PyPI/GitHub (MIT license)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":66.8,"security_score":21.8,"reliability_score":36.2,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":10.0,"tls_enforcement":15.0,"auth_strength":10.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":40.0,"security_notes":"Security posture is unclear: README does not mention authentication/authorization, transport security for the web interface, or logging redaction. The tool enables arbitrary command execution in local terminals, which increases risk if accessible to untrusted actors. Dependencies listed are common libraries, but no vulnerability/CVE or hardening details are provided.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":40.0,"error_recovery":70.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are documented for create/execute operations; repeated calls may re-run commands or create duplicate sessions depending on session identifiers and implementation.","pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["README suggests MCP tool definitions may be cached by the IDE; restart IDE if tools descriptions appear incorrect","Use batch tools (create_batch/execute_batch) instead of single tools for concurrency/non-blocking behavior","Conversations should avoid repeated get_output polling loops; rely on check_completion/check_completion flow or documented anti-loop behavior"]}}