A real project · 可核验公开档案

Onirika

一扇不要求远方安装任何东西的门。让本地的MCP客户端，沿着已经认证的SSH会话抵达远程服务器。

Verified architecture · 已核验架构

MCP clientClaude Code
或兼容工具

Onirika本地 stdio
MCP server

ControlMaster复用已认证的
SSH socket

Remote标准 Linux/bash
零额外安装

Boundary of trust · 信任边界

困难的认证，
只完成一次。

Kerberos、2FA、SSH key、密码或 ProxyJump 都由OpenSSH处理。使用者先在终端中完成交互认证，Onirika随后只复用ControlMaster socket；凭据不会穿过MCP协议，也不需要交给模型。

长时间任务可以在后台运行并轮询状态；文件写入采用临时文件加原子移动，避免半截内容留在远端。对于Claude Code原生SSH无法处理的交互认证，项目还提供仅监听 `127.0.0.1` 的本地SSH gateway。

Observed capabilities · 仓库所载能力

Files读取、原子写入、补丁、移动、删除、下载与元数据检查。

Commands前台执行、后台任务、状态轮询、输出截断与环境前置脚本。

Search在远程主机上按文件名查找，或使用正则搜索源码内容。

Git查看状态、差异与历史，同时让凭据继续留在SSH边界内。

Quick start · local terminal

$ git clone https://github.com/xinyue-uoft/Onirika.git
$ cd Onirika
$ uv tool install .
$ onirika setup
$ onirika launch <host-alias>