通用 MCP 客戶端

local-shell-mcp 可供 ChatGPT 使用，也可供其它 MCP 客戶端使用。客戶端決定是通過 HTTP 連接，還是通過 stdio 啓動服務。

HTTP MCP 客戶端

當服務已經在運行時，使用 HTTP 模式：

LOCAL_SHELL_MCP_WORKSPACE_ROOT=/path/to/workspace local-shell-mcp --mode mcp

本地端點：

http://127.0.0.1:8765/mcp

網絡端點：

https://your-public-host.example.com/mcp

任何超出可信 localhost 範圍可訪問的端點都應使用 OAuth。

Stdio MCP 客戶端

當客戶端自己啓動服務進程時，使用 stdio 模式：

LOCAL_SHELL_MCP_WORKSPACE_ROOT=/path/to/workspace local-shell-mcp --mode stdio

典型客戶端配置結構：

{
  "mcpServers": {
    "local-shell-mcp": {
      "command": "local-shell-mcp",
      "args": ["--mode", "stdio"],
      "env": {
        "LOCAL_SHELL_MCP_WORKSPACE_ROOT": "/path/to/workspace"
      }
    }
  }
}

不同客戶端 schema 不完全相同。有些叫 mcpServers，也有些使用其它名稱。

連接器式 search / fetch

服務也暴露只讀的連接器式 search 和 fetch 工具。它們適合基本文件發現，但不能替代完整 MCP 工具面。

使用 /mcp 才能獲得完整的 shell、文件系統、Git、瀏覽器、文件鏈接和遠程 worker 工具。

第一次安全檢查

新客戶端連接後，先執行：

調用 environment_info，然後對工作區根目錄調用 tree_view。暫時不要修改文件。

之後再運行帶有明確編輯、測試和 Git 規則的有邊界任務。