ssh-remote
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SSH_REMOTE_KEY | No | 私钥路径,默认 ~/.ssh/id_ed25519 | ~/.ssh/id_ed25519 |
| SSH_REMOTE_BASE | Yes | 远端工作目录,必须是绝对路径 | |
| SSH_REMOTE_HOME | No | ~ 展开的基准,默认 /home/$SSH_REMOTE_USER | /home/$SSH_REMOTE_USER |
| SSH_REMOTE_HOST | Yes | 目标主机地址 | |
| SSH_REMOTE_PORT | No | SSH 端口,默认 22 | 22 |
| SSH_REMOTE_USER | Yes | 登录用户名 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| remote_execB | 在远端服务器执行命令。默认工作目录是 SSH_REMOTE_BASE 指定的目录。把多条命令用 && 串成一次调用更省时间——成本在调用次数,不在命令条数。 |
| remote_readB | 读取远端文件。支持按行区间读取,返回带行号以便后续精确修改。 |
| remote_writeB | 整文件写入远端。改大文件前建议先 remote_read 确认内容。 |
| remote_replaceB | 在远端文件里做精确字符串替换,无需传整个文件。old_string 必须唯一匹配,否则报错——这是为了防止改错地方。 |
| remote_listB | 列出远端目录内容,返回类型、大小、修改时间。 |
| remote_searchA | 在远端按内容搜索(优先 ripgrep,远端没装时回退 grep)。适合跨文件找符号、找引用。 |
| remote_findA | 在远端按文件名查找(走 fd-find,缺失时回退 find)。比 remote_list 递归快得多。 |
| remote_statB | 查看远端文件或目录是否存在及其属性(类型、大小、修改时间、权限)。 |
| remote_healthA | 查看 SSH 长连接状态;断线时会自动重连一次。 |
| remote_exec_bgA | 后台起一个远端任务,立即返回不等待。适合编译、全量测试、构建镜像这类几分钟的活——返回 jobId,之后用 remote_job_check 查结果。任务状态存在远端文件系统上,本工具重启、甚至 WorkBuddy 重启后照样能接着查。 |
| remote_job_checkA | 查一个后台任务的状态与输出。返回 running / done / failed,终态时带退出码和日志末尾若干行。 |
| remote_job_listB | 列出当前所有后台任务,含在跑的和已结束的(按开始时间倒序)。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Tools are largely distinct: remote_list (single dir), remote_find (recursive by name), remote_search (by content), and remote_stat (specific path properties) have clearly different scopes, and exec vs exec_bg vs job_check/list are well separated. There is mild overlap in the cluster of 'inspect the filesystem' tools, but descriptions disambiguate them adequately.
Every tool uses a consistent remote_ prefix followed by a clear verb or verb_noun suffix (remote_list, remote_read, remote_write, remote_exec_bg, remote_job_check). The pattern is predictable throughout with no convention mixing.
12 tools is well within scope for a remote file-and-exec server, and each tool covers a distinct operation (listing, searching, reading, writing, replacing, executing, background jobs, health). No redundancy or padding.
Core file lifecycle (read, write, replace) plus search, exec, and background-job management are covered, but there is no explicit delete, mkdir, or move/rename operation. These gaps are workaround-able via remote_exec shell commands, so they are minor rather than blocking.