SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台claude-terminal-mcp

claude-terminal-mcp

claude-terminal-mcp 是一个面向 Linux 上 Claude Desktop 的开源扩展，为 Claude 提供终端、文件系统和后台任务访问能力。它填补了 Linux 平台上 Claude Desktop 无法通过 claude_desktop_config.json 加载 MCP 服务器的空白——该机制仅适用于 macOS/Windows，在 Linux 上只能通过可安装扩展添加工具。该扩展是零依赖的纯 Node 实现，采用 MIT 许可，向 Claude 暴露 8 个工具，运行状态保存在 /tmp/claude-term-mcp/ 并在重启时清除。重要安全提示：安装后 Claude 将以你的用户权限获得不受限制的 Shell 访问，可读写你的文件、安装软件、建立网络连接等，应像对待 SSH 会话一样谨慎，不要安装在含敏感数据的机器或共享系统上。内置仅有一个最小的破坏性命令拒绝列表（如 rm -rf /、fork 炸弹、裸磁盘 dd/mkfs、shutdown/reboot），这只是最后的安全网而非沙箱，可被轻易绕过。要求 Claude Desktop ≥ 0.10.0（Linux，macOS 亦经测试）和 Node.js ≥ 16（Claude Desktop 自带 Node 即可）。无数据外传、无遥测。

访问官网

工具介绍

用途

claude-terminal-mcp 是 Linux 平台上 Claude Desktop 的一个扩展，让 Claude 能够访问你的本地终端、文件系统和后台任务。它针对的是 Linux 上 Claude Desktop 的一个空缺：类似 claude_desktop_config.json 的 MCP 服务器加载机制只在 macOS/Windows 上有效，而在 Linux 上，添加工具的唯一方式是使用可安装的扩展。项目为开源、MIT 许可、零依赖。

主要能力

该扩展向 Claude 暴露 8 个工具，覆盖终端命令执行、文件系统操作和后台任务管理。运行状态（命令记录、任务临时文件）保存在 /tmp/claude-term-mcp/，并在每次重启时被清除。

安装与使用方式

  1. 从 Releases 页面下载最新的 Terminal.mcpb。
  2. 打开 Claude Desktop → Settings → Extensions。
  3. 滚动到底部的 Extension Developer（扩展开发者）区域，点击 Install Extension，选择下载的 Terminal.mcpb 文件。
  4. Claude Desktop 会显示扩展详情，并带有红色“developer info not verified by Anthropic”警告。确认信任来源后点击 Install。
  5. 安装时会要求设置一个 Default working directory（默认工作目录），即 Claude 未指定目录时运行命令的位置。可选择你的主项目文件夹，或留空以默认为你的主目录。
  6. 回到 All extensions，确保 Terminal 已开启。
  7. 在对话中打开连接器/工具选择器，为该对话启用 Terminal。

默认工作目录之后可在 Settings → Extensions → Terminal 中修改。所有配置都通过 Claude Desktop 的界面完成。若要自定义拒绝列表或其他行为，需编辑 server.js 并重新构建。

适用场景与限制

适用于希望在 Linux 上让 Claude Desktop 获得本地终端与文件访问能力的用户。要求 Claude Desktop ≥ 0.10.0（Linux，macOS 亦经测试），Node.js ≥ 16（Claude Desktop 自带的 Node 即可运行该扩展，无需系统 Node），且无需 npm install——扩展为纯 Node 零依赖。

安全限制需重点注意：安装此扩展即授予 Claude 在你用户账户下不受限制的 Shell 访问权限。你的用户能在终端做的一切，Claude 都能通过该工具做到：读取你可读的任何文件、修改你可修改的任何内容、安装软件、建立网络连接等。请像对待“给某人一个到你机器的 SSH 会话”一样对待安装行为。不要安装在含有你不希望 Claude 看到的敏感数据的机器上，也不要安装在共享系统中。

内置仅有一个最小的安全拒绝列表，会拒绝少数明显破坏性的一行命令（rm -rf /、rm -rf ~、fork 炸弹、对裸磁盘设备的 dd/mkfs、shutdown/reboot）。这只是最后的安全网，不是沙箱；有意为之的命令可轻易绕过。它的存在是为了避免一时的疏忽清空你的主目录。要收紧限制，可编辑 server.js 顶部的 DENYLIST 数组并重新构建；要完全移除，可设置 DENYLIST = [] 并重新构建。

隐私说明

无数据离开你的机器，扩展完全本地运行：不收集数据，不回传、不发送遥测、自身不发起任何网络请求；你观察到的网络调用都是你要求 Claude 运行的（如 curl、wget、git push）。命令记录（不含 stdin，含 stdout + stderr + exit code）写入 /tmp/claude-term-mcp/runs/<timestamp>.log，供 Claude 在同一对话中后续引用；后台任务状态（命令、pid、stdout/stderr 日志文件、退出码、状态）写入 /tmp/claude-term-mcp/jobs/<job-id>/。不向 Anthropic、扩展作者或任何第三方传输任何内容（Claude Desktop 本身在正常聊天流程中会向 Anthropic 发送工具输入/输出，这属于 Anthropic 与你之间的关系，而非本扩展所为）。/tmp/claude-term-mcp/ 在每次重启时清除，也可手动执行 rm -rf /tmp/claude-term-mcp 清除。命令以你自己的用户权限运行，与你在终端中输入相同。

已知问题

黄色横幅“Tool result could not be submitted. The request may have expired or the connection was interrupted.”会在每一轮触发 Claude 动态工具加载步骤时出现。该 404 发生在向 Anthropic 后端提交工具搜索结果时，而非 MCP 工具本身——横幅出现后你的工具调用会立即正确执行并返回。这是显示层面的问题，同样影响官方的 Filesystem 扩展，可能是客户端与后端的协议不匹配，预计会在未来的 Claude Desktop 版本中修复。

许可

MIT。可自由使用，欢迎署名，无担保。问题反馈可在 https://github.com/LukeLamb/claude-terminal-mcp/issues 提交。

同类工具

查看分类