ssh-mcp-vn 0.1.0__tar.gz

ssh_mcp_vn-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: ssh-mcp-vn
+Version: 0.1.0
+Summary: High-performance SSH & SFTP MCP Server for Linux
+Author-email: NamHT <namht@example.com>
+License: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: asyncssh>=2.14.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: pydantic-settings>=2.4.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+
+# SSH & SFTP MCP Server (ssh-mcp-vn)
+
+Một MCP (Model Context Protocol) Server mạnh mẽ dùng để thực thi lệnh (SSH) và truyền tải file (SFTP) trên **nhiều máy chủ Linux từ xa (multi-host)** cùng lúc.
+
+## Hướng dẫn cài đặt
+
+### Chạy qua UVX (Được khuyến nghị)
+Bạn có thể chạy trực tiếp server này qua `uvx` mà không cần phải tải hay cài đặt thủ công:
+
+```bash
+uvx ssh-mcp-vn
+```
+
+## Các tính năng chính
+
+- **Hỗ trợ Multi-host**: Có thể tương tác với nhiều máy chủ Linux mà không cần chạy nhiều instance.
+- **Thực thi qua SSH**: Chạy lệnh bash/shell tùy ý trên máy chủ từ xa.
+- **Quản lý thư mục**: Dễ dàng tạo cấu trúc thư mục từ xa (hoạt động giống lệnh `mkdir -p`).
+- **Tải lên qua SFTP**: Đẩy file từ máy tính cá nhân lên máy chủ từ xa.
+- **Tải về qua SFTP**: Tải file từ máy chủ từ xa về máy tính.
+- **Liệt kê file bằng SFTP**: Xem danh sách các file trong một thư mục bất kỳ trên máy chủ.
+
+## Cấu hình
+
+MCP server này hỗ trợ nhận cấu hình dạng một chuỗi JSON (JSON string) qua biến môi trường `SSH_SERVERS`. Trong file `mcp_config.json`, bạn cấu hình theo định dạng như sau:
+
+```json
+{
+  "mcpServers": {
+    "ssh-server": {
+      "command": "uvx",
+      "args": [
+        "ssh-mcp-vn"
+      ],
+      "env": {
+        "SSH_SERVERS": "[{\"host\":\"192.168.1.100\", \"user\":\"root\", \"password\":\"mat_khau_1\", \"port\":22}, {\"host\":\"192.168.1.101\", \"user\":\"ubuntu\", \"key_path\":\"/path/to/key.pem\"}]"
+      }
+    }
+  }
+}
+```
+
+### Các trường trong mảng JSON cấu hình
+Trong mảng JSON cấu hình (`SSH_SERVERS`), mỗi object hỗ trợ các trường sau:
+- `host` (bắt buộc): Địa chỉ IP hoặc Hostname của máy chủ SSH.
+- `user` (bắt buộc): Tên đăng nhập (username).
+- `port` (tùy chọn): Cổng SSH, mặc định là 22.
+- `password` (tùy chọn): Mật khẩu đăng nhập.
+- `key_path` (tùy chọn): Đường dẫn tuyệt đối đến file khóa bí mật (private key) nếu dùng key để đăng nhập.
+
+## Danh sách công cụ (Tools)
+
+*(Tất cả các công cụ đều yêu cầu tham số `host` để hệ thống biết sẽ thao tác trên máy chủ nào).*
+
+- `ssh_execute_command`: Chạy một lệnh shell trên máy Linux từ xa.
+- `ssh_create_folder`: Tạo thư mục từ xa.
+- `sftp_upload_file`: Chuyển một file từ local lên máy chủ.
+- `sftp_download_file`: Lấy một file từ máy chủ về local.
+- `sftp_list_directory`: Liệt kê tất cả file trong một thư mục từ xa.
+
+## License
+MIT

ssh_mcp_vn-0.1.0/README.md

@@ -0,0 +1,62 @@
+# SSH & SFTP MCP Server (ssh-mcp-vn)
+
+Một MCP (Model Context Protocol) Server mạnh mẽ dùng để thực thi lệnh (SSH) và truyền tải file (SFTP) trên **nhiều máy chủ Linux từ xa (multi-host)** cùng lúc.
+
+## Hướng dẫn cài đặt
+
+### Chạy qua UVX (Được khuyến nghị)
+Bạn có thể chạy trực tiếp server này qua `uvx` mà không cần phải tải hay cài đặt thủ công:
+
+```bash
+uvx ssh-mcp-vn
+```
+
+## Các tính năng chính
+
+- **Hỗ trợ Multi-host**: Có thể tương tác với nhiều máy chủ Linux mà không cần chạy nhiều instance.
+- **Thực thi qua SSH**: Chạy lệnh bash/shell tùy ý trên máy chủ từ xa.
+- **Quản lý thư mục**: Dễ dàng tạo cấu trúc thư mục từ xa (hoạt động giống lệnh `mkdir -p`).
+- **Tải lên qua SFTP**: Đẩy file từ máy tính cá nhân lên máy chủ từ xa.
+- **Tải về qua SFTP**: Tải file từ máy chủ từ xa về máy tính.
+- **Liệt kê file bằng SFTP**: Xem danh sách các file trong một thư mục bất kỳ trên máy chủ.
+
+## Cấu hình
+
+MCP server này hỗ trợ nhận cấu hình dạng một chuỗi JSON (JSON string) qua biến môi trường `SSH_SERVERS`. Trong file `mcp_config.json`, bạn cấu hình theo định dạng như sau:
+
+```json
+{
+  "mcpServers": {
+    "ssh-server": {
+      "command": "uvx",
+      "args": [
+        "ssh-mcp-vn"
+      ],
+      "env": {
+        "SSH_SERVERS": "[{\"host\":\"192.168.1.100\", \"user\":\"root\", \"password\":\"mat_khau_1\", \"port\":22}, {\"host\":\"192.168.1.101\", \"user\":\"ubuntu\", \"key_path\":\"/path/to/key.pem\"}]"
+      }
+    }
+  }
+}
+```
+
+### Các trường trong mảng JSON cấu hình
+Trong mảng JSON cấu hình (`SSH_SERVERS`), mỗi object hỗ trợ các trường sau:
+- `host` (bắt buộc): Địa chỉ IP hoặc Hostname của máy chủ SSH.
+- `user` (bắt buộc): Tên đăng nhập (username).
+- `port` (tùy chọn): Cổng SSH, mặc định là 22.
+- `password` (tùy chọn): Mật khẩu đăng nhập.
+- `key_path` (tùy chọn): Đường dẫn tuyệt đối đến file khóa bí mật (private key) nếu dùng key để đăng nhập.
+
+## Danh sách công cụ (Tools)
+
+*(Tất cả các công cụ đều yêu cầu tham số `host` để hệ thống biết sẽ thao tác trên máy chủ nào).*
+
+- `ssh_execute_command`: Chạy một lệnh shell trên máy Linux từ xa.
+- `ssh_create_folder`: Tạo thư mục từ xa.
+- `sftp_upload_file`: Chuyển một file từ local lên máy chủ.
+- `sftp_download_file`: Lấy một file từ máy chủ về local.
+- `sftp_list_directory`: Liệt kê tất cả file trong một thư mục từ xa.
+
+## License
+MIT

ssh_mcp_vn-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ssh-mcp-vn"
+version = "0.1.0"
+description = "High-performance SSH & SFTP MCP Server for Linux"
+readme = "README.md"
+authors = [
+    { name = "NamHT", email = "namht@example.com" }
+]
+license = { text = "MIT" }
+requires-python = ">=3.12"
+dependencies = [
+    "mcp>=1.2.0",
+    "asyncssh>=2.14.0",
+    "pydantic>=2.8.0",
+    "pydantic-settings>=2.4.0",
+    "python-dotenv>=1.0.0"
+]
+
+[project.scripts]
+ssh-mcp-vn = "ssh_mcp_server:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "ruff>=0.5.0",
+    "mypy>=1.10.0"
+]

ssh_mcp_vn-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ssh_mcp_vn-0.1.0/src/ssh_mcp_server.py

@@ -0,0 +1,177 @@
+import os
+import sys
+import json
+import argparse
+import asyncssh
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+from mcp.server.fastmcp import FastMCP
+
+class ServerConfig(BaseModel):
+    host: str
+    user: str
+    port: int = 22
+    password: Optional[str] = None
+    key_path: Optional[str] = None
+
+class SshSettings(BaseSettings):
+    servers: str = "[]" # JSON string array of server configs
+
+    model_config = SettingsConfigDict(
+        env_prefix="SSH_",
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore"
+    )
+
+mcp = FastMCP("ssh-mcp-vn", description="SSH and SFTP Server (Multi-host)")
+
+_parsed_servers: Dict[str, ServerConfig] = {}
+
+def get_parsed_servers() -> Dict[str, ServerConfig]:
+    global _parsed_servers
+    if not _parsed_servers:
+        settings = SshSettings()
+        try:
+            servers_list = json.loads(settings.servers)
+            for s in servers_list:
+                config = ServerConfig(**s)
+                _parsed_servers[config.host] = config
+        except Exception as e:
+            print(f"Error parsing SSH_SERVERS JSON: {e}", file=sys.stderr)
+    return _parsed_servers
+
+def get_server_config(host: str) -> ServerConfig:
+    servers = get_parsed_servers()
+    if host not in servers:
+        raise ValueError(f"Server configuration for host '{host}' not found.")
+    return servers[host]
+
+async def create_connection(host: str) -> asyncssh.SSHClientConnection:
+    config = get_server_config(host)
+    
+    connect_kwargs: Dict[str, Any] = {
+        "host": config.host,
+        "port": config.port,
+        "username": config.user,
+        "known_hosts": None # Accept any host key for simplicity in automated environments
+    }
+    
+    if config.password:
+        connect_kwargs["password"] = config.password
+    if config.key_path:
+        connect_kwargs["client_keys"] = [config.key_path]
+        
+    return await asyncssh.connect(**connect_kwargs)
+
+@mcp.tool()
+async def ssh_execute_command(host: str, command: str) -> str:
+    """Execute an arbitrary shell command on the remote Linux machine via SSH.
+    
+    Args:
+        host: The target SSH host IP or domain (must be configured in SSH_SERVERS).
+        command: The shell command to execute.
+    """
+    try:
+        async with await create_connection(host) as conn:
+            result = await conn.run(command, check=False)
+            output = f"Exit Status: {result.exit_status}\n"
+            if result.stdout:
+                output += f"STDOUT:\n{result.stdout}\n"
+            if result.stderr:
+                output += f"STDERR:\n{result.stderr}\n"
+            return output
+    except Exception as e:
+        return f"Error executing command on {host}: {str(e)}"
+
+@mcp.tool()
+async def ssh_create_folder(host: str, path: str) -> str:
+    """Create a directory on the remote machine. Parents are created as needed (like mkdir -p).
+    
+    Args:
+        host: The target SSH host IP or domain.
+        path: The remote path to create.
+    """
+    command = f"mkdir -p \"{path}\""
+    return await ssh_execute_command(host, command)
+
+@mcp.tool()
+async def sftp_upload_file(host: str, local_path: str, remote_path: str) -> str:
+    """Upload a file from the local machine to the remote machine via SFTP.
+    
+    Args:
+        host: The target SSH host IP or domain.
+        local_path: Absolute path to the file on the local machine.
+        remote_path: Absolute or relative path on the remote machine.
+    """
+    try:
+        if not os.path.isfile(local_path):
+            return f"Error: Local file '{local_path}' does not exist."
+            
+        async with await create_connection(host) as conn:
+            async with conn.start_sftp_client() as sftp:
+                await sftp.put(local_path, remote_path)
+        return f"Successfully uploaded '{local_path}' to '{remote_path}' on {host}"
+    except Exception as e:
+        return f"Error uploading file to {host}: {str(e)}"
+
+@mcp.tool()
+async def sftp_download_file(host: str, remote_path: str, local_path: str) -> str:
+    """Download a file from the remote machine to the local machine via SFTP.
+    
+    Args:
+        host: The target SSH host IP or domain.
+        remote_path: Absolute or relative path on the remote machine.
+        local_path: Absolute path to save the file on the local machine.
+    """
+    try:
+        local_dir = os.path.dirname(local_path)
+        if local_dir and not os.path.exists(local_dir):
+            os.makedirs(local_dir, exist_ok=True)
+            
+        async with await create_connection(host) as conn:
+            async with conn.start_sftp_client() as sftp:
+                await sftp.get(remote_path, local_path)
+        return f"Successfully downloaded '{remote_path}' from {host} to '{local_path}'"
+    except Exception as e:
+        return f"Error downloading file from {host}: {str(e)}"
+
+@mcp.tool()
+async def sftp_list_directory(host: str, path: str) -> str:
+    """List the contents of a directory on the remote machine via SFTP.
+    
+    Args:
+        host: The target SSH host IP or domain.
+        path: The remote directory path to list.
+    """
+    try:
+        async with await create_connection(host) as conn:
+            async with conn.start_sftp_client() as sftp:
+                files = await sftp.readdir(path)
+                
+                result = []
+                for f in files:
+                    attrs = f.attrs
+                    size = attrs.size if attrs.size is not None else 0
+                    result.append(f"{f.filename} (Size: {size} bytes)")
+                
+                if not result:
+                    return f"Directory '{path}' on {host} is empty."
+                return "\\n".join(result)
+    except Exception as e:
+        return f"Error listing directory on {host}: {str(e)}"
+
+def main():
+    parser = argparse.ArgumentParser(description="SSH MCP Server")
+    parser.add_argument("--servers", help="JSON string containing an array of SSH server configurations")
+    
+    args = parser.parse_args()
+    
+    if args.servers:
+        os.environ["SSH_SERVERS"] = args.servers
+    
+    mcp.run(transport='stdio')
+
+if __name__ == "__main__":
+    main()

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: ssh-mcp-vn
+Version: 0.1.0
+Summary: High-performance SSH & SFTP MCP Server for Linux
+Author-email: NamHT <namht@example.com>
+License: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: asyncssh>=2.14.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: pydantic-settings>=2.4.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+
+# SSH & SFTP MCP Server (ssh-mcp-vn)
+
+Một MCP (Model Context Protocol) Server mạnh mẽ dùng để thực thi lệnh (SSH) và truyền tải file (SFTP) trên **nhiều máy chủ Linux từ xa (multi-host)** cùng lúc.
+
+## Hướng dẫn cài đặt
+
+### Chạy qua UVX (Được khuyến nghị)
+Bạn có thể chạy trực tiếp server này qua `uvx` mà không cần phải tải hay cài đặt thủ công:
+
+```bash
+uvx ssh-mcp-vn
+```
+
+## Các tính năng chính
+
+- **Hỗ trợ Multi-host**: Có thể tương tác với nhiều máy chủ Linux mà không cần chạy nhiều instance.
+- **Thực thi qua SSH**: Chạy lệnh bash/shell tùy ý trên máy chủ từ xa.
+- **Quản lý thư mục**: Dễ dàng tạo cấu trúc thư mục từ xa (hoạt động giống lệnh `mkdir -p`).
+- **Tải lên qua SFTP**: Đẩy file từ máy tính cá nhân lên máy chủ từ xa.
+- **Tải về qua SFTP**: Tải file từ máy chủ từ xa về máy tính.
+- **Liệt kê file bằng SFTP**: Xem danh sách các file trong một thư mục bất kỳ trên máy chủ.
+
+## Cấu hình
+
+MCP server này hỗ trợ nhận cấu hình dạng một chuỗi JSON (JSON string) qua biến môi trường `SSH_SERVERS`. Trong file `mcp_config.json`, bạn cấu hình theo định dạng như sau:
+
+```json
+{
+  "mcpServers": {
+    "ssh-server": {
+      "command": "uvx",
+      "args": [
+        "ssh-mcp-vn"
+      ],
+      "env": {
+        "SSH_SERVERS": "[{\"host\":\"192.168.1.100\", \"user\":\"root\", \"password\":\"mat_khau_1\", \"port\":22}, {\"host\":\"192.168.1.101\", \"user\":\"ubuntu\", \"key_path\":\"/path/to/key.pem\"}]"
+      }
+    }
+  }
+}
+```
+
+### Các trường trong mảng JSON cấu hình
+Trong mảng JSON cấu hình (`SSH_SERVERS`), mỗi object hỗ trợ các trường sau:
+- `host` (bắt buộc): Địa chỉ IP hoặc Hostname của máy chủ SSH.
+- `user` (bắt buộc): Tên đăng nhập (username).
+- `port` (tùy chọn): Cổng SSH, mặc định là 22.
+- `password` (tùy chọn): Mật khẩu đăng nhập.
+- `key_path` (tùy chọn): Đường dẫn tuyệt đối đến file khóa bí mật (private key) nếu dùng key để đăng nhập.
+
+## Danh sách công cụ (Tools)
+
+*(Tất cả các công cụ đều yêu cầu tham số `host` để hệ thống biết sẽ thao tác trên máy chủ nào).*
+
+- `ssh_execute_command`: Chạy một lệnh shell trên máy Linux từ xa.
+- `ssh_create_folder`: Tạo thư mục từ xa.
+- `sftp_upload_file`: Chuyển một file từ local lên máy chủ.
+- `sftp_download_file`: Lấy một file từ máy chủ về local.
+- `sftp_list_directory`: Liệt kê tất cả file trong một thư mục từ xa.
+
+## License
+MIT

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/ssh_mcp_server.py
+src/ssh_mcp_vn.egg-info/PKG-INFO
+src/ssh_mcp_vn.egg-info/SOURCES.txt
+src/ssh_mcp_vn.egg-info/dependency_links.txt
+src/ssh_mcp_vn.egg-info/entry_points.txt
+src/ssh_mcp_vn.egg-info/requires.txt
+src/ssh_mcp_vn.egg-info/top_level.txt

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ssh-mcp-vn = ssh_mcp_server:main

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/requires.txt

@@ -0,0 +1,12 @@
+mcp>=1.2.0
+asyncssh>=2.14.0
+pydantic>=2.8.0
+pydantic-settings>=2.4.0
+python-dotenv>=1.0.0
+
+[dev]
+pytest>=8.0.0
+pytest-asyncio>=0.23.0
+pytest-cov>=4.1.0
+ruff>=0.5.0
+mypy>=1.10.0

ssh_mcp_vn-0.1.0/src/ssh_mcp_vn.egg-info/top_level.txt

@@ -0,0 +1 @@
+ssh_mcp_server