Metadata-Version: 2.4
Name: ssh-ide-mcp
Version: 1.0.0
Summary: SSH IDE — Remote SSH IDE with Jupyter notebook support, file browser, and MCP tools for AI agents
Home-page: https://github.com/your-username/ssh-ide-mcp
Author: SSH IDE Team
Author-email: 
Keywords: ssh,mcp,jupyter,ide,remote,sftp,notebook
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: paramiko>=2.8.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.20.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: websockets>=10.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# SSH IDE MCP

**Remote SSH IDE with Jupyter notebook support + MCP tools for AI agents.**

Connect to Linux servers via SSH, browse/edit files, execute Python/Jupyter code — 
all through a Web IDE interface **and** AI agent tools (MCP protocol).

```
pip install ssh-ide-mcp
```

## Features

- 🔌 **SSH Connection** — Key or password auth, persistent sessions
- 📁 **File Browser** — VS Code-style sidebar, browse remote files
- ✏️ **Code Editor** — Monaco Editor (VS Code engine) with syntax highlighting
- 📓 **Jupyter Notebooks** — View, edit, and execute .ipynb cells remotely
- 🐍 **Python Execution** — Run Python code in any environment (conda, system)
- 🖥️ **Terminal** — Web-based terminal via SSH
- 🤖 **MCP Tools** — 25+ MCP tools for AI agents to control remote servers
- 🔄 **Universal** — Works with Reasonix, Cursor, Claude Code, Codex, and any MCP client

## Quick Start

### 1. Install

```bash
pip install ssh-ide-mcp
```

### 2a. Start Web IDE (human interface)

```bash
ssh-ide-mcp web 8765
```

Open http://localhost:8765 in your browser.

### 2b. Start MCP Server (AI agent interface)

```bash
ssh-ide-mcp mcp
```

For Reasonix/Cursor/Claude Code, add to `.mcp.json`:

```json
{
  "ssh-ide-mcp": {
    "command": "ssh-ide-mcp",
    "args": ["mcp"],
    "env": {}
  }
}
```

### 3. Connect to your server

**Via Web UI:** Fill in hostname, username, password → click Connect

**Via AI agent:** Tell your AI agent:

> "SSH connect to 172.19.247.29 as rchen, password: YwL7qc7wcn, workdir: /cluster2/huanglab/rchen"

## MCP Tools (for AI Agents)

| Category | Tools |
|----------|-------|
| **Connection** | `ssh_connect`, `ssh_disconnect`, `ssh_connections`, `ssh_save_host`, `ssh_connect_saved`, `ssh_list_hosts` |
| **Command** | `ssh_exec` |
| **Files** | `ssh_read_file`, `ssh_write_file`, `ssh_edit_string`, `ssh_delete_range` |
| **Directory** | `ssh_ls`, `ssh_glob`, `ssh_stat`, `ssh_file_tree` |
| **Transfer** | `ssh_download`, `ssh_upload` |
| **Python** | `ssh_execute_python`, `ssh_list_environments` |
| **Notebook** | `ssh_read_notebook`, `ssh_execute_notebook_cell`, `ssh_edit_notebook_cell`, `ssh_add_notebook_cell`, `ssh_delete_notebook_cell` |
| **Web** | `web_ide_url` |

## Web UI Screenshot

```
┌──────────────────────────────────────────────────────────┐
│ Tab Bar: [file.py] [notebook.ipynb] [Terminal]  ● Connected │
├────────────────────────────────────┬─────────────────────┤
│                                    │  📁 File Tree       │
│  Monaco Editor / Notebook Viewer   │  ├── src/           │
│                                    │  │   ├── main.py    │
│  (Edit and execute code here)      │  │   └── utils.py   │
│                                    │  ├── notebooks/     │
│                                    │  │   └── analysis   │
│                                    │  └── config.yml     │
│                                    ├─────────────────────┤
│                                    │  🐍 Env: Python 3   │
└────────────────────────────────────┴─────────────────────┘
```

## Configuration

Host configs saved at `~/.ssh-ide-mcp/config.json`.

## Requirements

- Python 3.9+
- Remote server: SSH access, Python 3 (for Jupyter execution)

## License

MIT
