MCP Server

Overview

TransHub AI includes an MCP (Model Context Protocol) server that exposes your SSH capabilities to AI tools like Claude Desktop, Claude Code, and other MCP-compatible clients.

Transports

Standalone stdio Server (Primary)

For use with Claude Desktop and other MCP clients:

File: ~/.local/bin/transhub-mcp.mjs
Transport: JSON-RPC over stdin/stdout
Dependencies: None (pure Node.js)
Auto-installed on first app launch

Claude Desktop Configuration

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "transhub-ai": {
      "command": "node",
      "args": ["~/.local/bin/transhub-mcp.mjs"]
    }
  }
}

Embedded HTTP Server (Secondary)

For use when the desktop app is running:

HTTP: POST http://localhost:3847/message
SSE: GET http://localhost:3847/sse
WebSocket: ws://localhost:3847

Available Tools

Core SSH (enabled by default)

ssh_list_servers — List all configured servers
ssh_execute — Run a command on a remote server
ssh_upload — Upload a file to a server
ssh_download — Download a file from a server
ssh_sync — Sync files between local and remote

Browser Automation (enabled by default)

browser_open, browser_navigate, browser_screenshot
browser_click, browser_type, browser_execute_js
Full browser automation suite for web testing and interaction

Monitoring (disabled by default)

ssh_health_check, ssh_service_status, ssh_process_manager
ssh_tail, ssh_monitor

Database (disabled by default)

ssh_db_list, ssh_db_query, ssh_db_dump, ssh_db_import

Backup (disabled by default)

ssh_backup_create, ssh_backup_list, ssh_backup_restore

Advanced (disabled by default)

ssh_execute_sudo, ssh_deploy, ssh_execute_group

Configuration

Enable or disable tool groups in Settings > MCP.

You can also configure:

Auto-start: Start MCP server when the app launches
Port: Change the HTTP server port
Max output size: Limit command output length (default: 10,000 characters)

Wiki