用于 Claude Code 的本地 MCP
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 机器的破坏性命令都会等待您的确认。