用于 Claude Code 的本地 MCP

更新于 2026年11月10日

konsolity mcp 会在标准输入和输出(stdio)上启动一个本地 MCP 服务器。在同一台机器上运行的 Claude 代理(例如 Claude Code)可以用它列出您的主机并在其上运行命令,所遵循的规则与 konsolity run 完全相同。整个过程不经过远程 Claude 连接器:代理直接与 CLI 通信。

机器必须已使用 mcp 域激活(对应的工具还需要 hosts、snippets)。

连接 Claude Code

claude mcp add konsolity -- konsolity mcp

确认服务器已被识别:

claude mcp list

Claude Code 会在每个会话开始时启动 konsolity mcp,并在会话结束时停止它。每个打开的 MCP 会话都会显示在账户的 CLI 会话列表中,并可在那里结束。

工具

工具 域 作用
list_hosts hosts 范围内的主机:标识符、标签、地址、用户、分组。不含任何机密。
list_snippets snippets 范围内的代码片段:标识符、名称、分组。
run_command hosts,完全访问 根据命令规则,在范围内的主机上运行命令。
run_snippet snippets + hosts,完全访问 在范围内的主机上运行代码片段。
list_sessions sessions 账户中正在运行的 CLI 会话。

只读访问时,仅提供列表类工具。

相同的规则

  • 主机不在范围内、命令不匹配任何规则:会被拒绝,并向代理返回清晰的消息,同时在日志中记录一行。
  • 破坏性命令:即使启用了“任意命令”,也需要先在应用或控制台中确认才会运行。
  • 超时时间:以机器的最大超时时间为上限(默认 60 秒,最长 1 小时)。
  • 撤销或结束会话:正在运行的命令会在 5 秒内停止,MCP 服务器也会停止。

输出受限

工具结果会返回退出码、耗时以及标准输出和错误输出,每项最多 64 KiB。超出部分会被截断,结果中会注明这一点。如需完整输出,请在终端中使用 konsolity run,其输出不受限制。

连接 Claude 的三种方式

konsolity mcp Claude 连接器 konsolity serve
使用的 Claude 同一台机器上的 Claude Code(或代理) claude.ai、Claude 应用 claude.ai、Claude 应用
传输方式 本地 stdio https://mcp.konsolity.com/mcp 连接器队列,由机器领取
由谁执行 这台机器上的 CLI 打开的桌面应用 作为服务运行、没有界面的 CLI
批准方式 机器的范围和规则 应用中的“允许一次” 机器的范围和规则
文档 本页 Claude 连接器 服务与存储

在所有情况下,来自 CLI 机器的破坏性命令都会等待您的确认。