本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

local-shell-mcp

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:fwerkor/local-shell-mcp

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Web UI is a native browser dashboard for system health, machines, workloads, recent MCP activity, and alerts.
• HPC login nodes or compute nodes behind firewalls.
• NPU/GPU servers without inbound connectivity.
• Lab machines that can make outbound HTTPS requests.
• Temporary build hosts or remote test environments.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上之后 DSH 里能看到什么？

聊天面板里会多一个"Live Workspace"标签页，里面是与 local-shell-mcp 实时同步的终端、文件、任务面板；模型可用的工具列表会按 mcp__lsm__ 前缀自动追加上游 MCP 服务声明的全部工具。

必须先启动 local-shell-mcp 服务吗？

是的。本插件只是桥接，不内置 MCP 服务，依赖 localhost:8765 上游，地址可通过 DSH_LSM_MCP_URL 环境变量或 cordis.patch.yml 里的 url 字段修改。

每个 DSH 会话是独立的吗？

是的。插件为每个 DSH Session 建立独立的 MCP 传输连接，并以会话亲和头标识，最多同时维护 64 个会话连接，超出时会按最近使用时间淘汰已结束的会话。

工具结果里包含图片或音频怎么办？

插件只把文本片段转发给模型，图片、音频、resource 类型的内容会被替换为"[image: …, content discarded]"这类占位提示，避免大块二进制进入对话上下文。

需要给本地服务加 Bearer Token 吗？

可选。在 DSH 进程环境里设置 DSH_LSM_AUTHORIZATION 即可透传到上游 MCP 请求头；也可以在 cordis.patch.yml 的 headers 字段直接写死。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则