Metadata-Version: 2.1
Name: ssh-nexus
Version: 0.1.0
Summary: AI-assisted SSH session and command-set workspace
Author: NetOpt
License: BSL-1.1
Requires-Python: >=3.12,<3.13
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Networking
Classifier: Topic :: Terminals
Requires-Dist: asyncssh>=2.20,<3
Requires-Dist: cryptography>=43.0
Requires-Dist: fastapi>=0.115
Requires-Dist: mcp[cli]>=1.26,<2
Requires-Dist: pydantic>=2.10
Requires-Dist: uvicorn[standard]>=0.34
Project-URL: Homepage, https://github.com/quwentao2005/mcp_dev
Description-Content-Type: text/markdown

<!--
mcp-name: io.github.quwentao2005/ssh-nexus
-->

# SSH Nexus

## 为什么做这个项目

在日常的网络学习和运维中，一台设备往往需要反复登录：自己要在终端里敲命令，AI 助手也想查看同一台设备的状态，浏览器里还开着另一个终端窗口。多份连接互相看不见对方的操作，输出各存一份，很容易出现命令重复执行、状态对不上的情况。

SSH Nexus 希望把「人、AI、Web 页面」连接到同一条 SSH 会话上：所有人看到同样的实时输出，凭据在本机加密保存，常用命令可以整理成命令集反复调用。

## 主要功能

- 集中管理 SSH 目标：保存主机、端口、用户名等连接信息。
- 凭据本地加密保存：密码或私钥使用本机密钥加密后存储，界面与 AI 都只能看到脱敏信息。
- 共享会话：Web 终端和 AI 使用同一条后端 SSH 连接，实时输出保持一致。
- 透明终端：终端只负责显示和输入，不修改设备返回的任何内容，保持真实命令行体验。
- 命令集：把常用命令整理成命名列表，可对一台或多台设备批量执行。
- 主机指纹保护：首次连接记录服务器指纹，之后每次连接都会先校验，防止连接到假冒主机。
- 默认只在本机运行，适合个人学习、实验和日常运维场景。

## 部署要求

- Windows 10 或 Windows 11
- Node.js 22 或更高版本
- [uv](https://docs.astral.sh/uv/getting-started/installation/)

## 安装

在 PowerShell 中执行：

```powershell
uv tool install --python 3.12 ssh-nexus
```

安装完成后，MCP 客户端使用以下配置：

```json
{
  "mcpServers": {
    "ssh-nexus": {
      "command": "ssh-nexus"
    }
  }
}
```

如果 MCP 客户端找不到 `ssh-nexus`，请执行：

```powershell
uv tool update-shell
```

然后重新启动 MCP 客户端。

## 开始使用

完成 MCP 配置后，可以直接对 AI 说：

> 请启动并打开 SSH Nexus Web 控制台。

AI 会启动本地服务并打开：

```text
http://localhost:3100
```

进入工作台后即可添加 SSH 目标、保存凭据、连接设备并开始操作。数据默认保存在本机的 SSH Nexus 数据目录中，更换 MCP 客户端的工作目录不会丢失已有配置。

## 更新

```powershell
uv tool upgrade ssh-nexus
```

## 项目主页

[GitHub：quwentao2005/mcp_dev](https://github.com/quwentao2005/mcp_dev)
