ellmos-servercommander-mcp 0.1.0-alpha.1 → 0.1.0-alpha.3

package/README.md

@@ -1,72 +1,84 @@
 # ellmos-servercommander-mcp
 
-Alpha-MCP-Server für Server-Operationen: Deployment-Planung, Mail-Status, Log-Analyse und HTTP-Health-Checks.
+<p align="center">
+  <img src="assets/servercommander-logo.jpg" alt="ellmos ServerCommander MCP logo" width="360">
+</p>
 
-## Status
-
-- Transport: stdio über das Python-MCP-SDK
-- Paketstatus: Alpha-Paket, GitHub-Repo unter `ellmos-ai` vorgesehen
-- Aktiver Kern: MCP-Tool-Liste, MCP-Tool-Dispatch, Config-Lader, `sc_logs_analyze`, `sc_health_check`
-- Sichere Alpha-Handler: `sc_deploy` erstellt lokale SHA256-Manifeste im Dry-run, `sc_mail_*` führt noch keine IMAP/SMTP-Aktionen aus
+Alpha MCP server for server operations: deployment dry-runs, mail status, access-log analysis, and HTTP health checks.
 
-## Installation für lokale Tests
+German README: [README_de.md](README_de.md)
 
-```powershell
-cd "C:\Users\User\OneDrive\.TOPICS\.AI\.MCP\ellmos-servercommander-mcp"
-$env:PYTHONIOENCODING = "utf-8"
-python -m pip install -e ".[dev]"
-python -m pytest -q
-```
+## Status
 
-Keine `.venv` im OneDrive-Ordner anlegen. Falls eine isolierte Umgebung gebraucht wird, außerhalb von OneDrive erstellen.
+- Transport: stdio via the Python MCP SDK
+- Package status: public alpha package under `ellmos-ai`
+- Current core: MCP tool listing, MCP tool dispatch, config loading, `sc_logs_analyze`, `sc_health_check`
+- Safe alpha handlers: `sc_deploy` builds local SHA256 manifests in dry-run mode; `sc_mail_*` does not perform IMAP/SMTP operations yet
+- i18n: localized MCP tool descriptions for `en`, `de`, `es`, `zh`, `ja`, `ru` with English fallback
 
-## npm Alpha
+## Install
 
-Das npm-Paket enthält einen Node-Wrapper, der den Python-Server startet. Voraussetzung bleibt Python 3.10+ mit installiertem Python-Paket `mcp>=1.0.0`.
+The npm package contains a Node wrapper that starts the Python server. You still need Python 3.10+ and the Python package `mcp>=1.0.0`.
 
 ```powershell
 npm install -g ellmos-servercommander-mcp@alpha
 ellmos-servercommander
 ```
 
-## Start
+For local development:
 
 ```powershell
-ellmos-servercommander
+cd "C:\Users\User\OneDrive\.TOPICS\.AI\.MCP\ellmos-servercommander-mcp"
+$env:PYTHONIOENCODING = "utf-8"
+python -m pip install -e ".[dev]"
+python -m pytest -q
 ```
 
-Oder direkt aus dem Quellbaum:
+Do not create a `.venv` inside a OneDrive-synced folder. If you need an isolated environment, create it outside OneDrive.
+
+## Start From Source
 
 ```powershell
 $env:PYTHONPATH = "src"
 python -m servercommander.server
 ```
 
-## Konfiguration
+## Configuration
 
-Beispiel: [config/servercommander.example.toml](config/servercommander.example.toml)
+Example: [config/servercommander.example.toml](config/servercommander.example.toml)
 
-Standardpfade:
+Default paths:
 
 - `%USERPROFILE%\.servercommander\config.toml`
 - `%USERPROFILE%\.config\servercommander\config.toml`
-- Override per `SERVERCOMMANDER_CONFIG`
+- override with `SERVERCOMMANDER_CONFIG`
+
+Language can be configured with `[server].language`, `SERVERCOMMANDER_LANG`, or `SERVERCOMMANDER_LOCALE`.
+
+```toml
+[server]
+name = "ellmos-servercommander"
+language = "en" # en, de, es, zh, ja, ru
+```
 
-Secrets sollen als Umgebungsvariablen referenziert werden, zum Beispiel `$MAIL_PASSWORD` oder `$SFTP_PASSWORD`.
+Secrets should be referenced through environment variables, for example `$MAIL_PASSWORD` or `$SFTP_PASSWORD`.
 
 ## Tools
 
-- `sc_health_check`: prüft HTTP-Endpunkte und meldet Status-Code plus Latenz
-- `sc_logs_analyze`: analysiert Apache-/Nginx-Access-Logs aus Text oder Datei
-- `sc_deploy`: erstellt im Alpha-Modus einen Deployment-Plan mit lokalem SHA256-Manifest, führt aber noch keinen Upload aus
-- `sc_deploy_status`: zeigt konfigurierte Deploy-Profile und den noch fehlenden History-Status
-- `sc_mail_list`, `sc_mail_read`, `sc_mail_send`, `sc_mail_search`: liefern aktuell sichere Alpha-Statusantworten ohne IMAP/SMTP-Verbindung
+- `sc_health_check`: checks HTTP endpoints and reports status code plus latency
+- `sc_logs_analyze`: analyzes Apache/Nginx access logs from inline text or a local file
+- `sc_deploy`: creates a deployment plan with a local SHA256 manifest, but does not upload yet
+- `sc_deploy_status`: shows configured deploy profiles and the current alpha history status
+- `sc_mail_list`, `sc_mail_read`, `sc_mail_send`, `sc_mail_search`: safe alpha status responses without IMAP/SMTP connections
 
-## Entwicklung
+## Development
 
 ```powershell
 $env:PYTHONIOENCODING = "utf-8"
+$env:PYTHONDONTWRITEBYTECODE = "1"
 python -m pytest -q
+npm run smoke
+npm pack --dry-run
 ```
 
-Der nächste sinnvolle Schritt ist die Extraktion der echten SFTP-, IMAP/SMTP- und erweiterten Traffic-Module aus `.UMBRUCH` in credential-freie Adapter mit lokalen Tests.
+Next useful step: extract real SFTP, IMAP/SMTP, and extended traffic-analysis modules from `.UMBRUCH` into credential-free adapters with local tests.

package/README_de.md

@@ -0,0 +1,84 @@
+# ellmos-servercommander-mcp
+
+<p align="center">
+  <img src="assets/servercommander-logo.jpg" alt="ellmos ServerCommander MCP Logo" width="360">
+</p>
+
+Alpha-MCP-Server für Server-Operationen: Deployment-Dry-runs, Mail-Status, Access-Log-Analyse und HTTP-Health-Checks.
+
+Englische Standard-README: [README.md](README.md)
+
+## Status
+
+- Transport: stdio über das Python-MCP-SDK
+- Paketstatus: öffentliches Alpha-Paket unter `ellmos-ai`
+- Aktiver Kern: MCP-Tool-Liste, MCP-Tool-Dispatch, Config-Lader, `sc_logs_analyze`, `sc_health_check`
+- Sichere Alpha-Handler: `sc_deploy` erstellt lokale SHA256-Manifeste im Dry-run, `sc_mail_*` führt noch keine IMAP/SMTP-Aktionen aus
+- i18n: lokalisierte MCP-Tool-Beschreibungen für `en`, `de`, `es`, `zh`, `ja`, `ru` mit Englisch-Fallback
+
+## Installation
+
+Das npm-Paket enthält einen Node-Wrapper, der den Python-Server startet. Voraussetzung bleibt Python 3.10+ mit installiertem Python-Paket `mcp>=1.0.0`.
+
+```powershell
+npm install -g ellmos-servercommander-mcp@alpha
+ellmos-servercommander
+```
+
+Für lokale Entwicklung:
+
+```powershell
+cd "C:\Users\User\OneDrive\.TOPICS\.AI\.MCP\ellmos-servercommander-mcp"
+$env:PYTHONIOENCODING = "utf-8"
+python -m pip install -e ".[dev]"
+python -m pytest -q
+```
+
+Keine `.venv` im OneDrive-Ordner anlegen. Falls eine isolierte Umgebung gebraucht wird, außerhalb von OneDrive erstellen.
+
+## Start Aus Dem Quellbaum
+
+```powershell
+$env:PYTHONPATH = "src"
+python -m servercommander.server
+```
+
+## Konfiguration
+
+Beispiel: [config/servercommander.example.toml](config/servercommander.example.toml)
+
+Standardpfade:
+
+- `%USERPROFILE%\.servercommander\config.toml`
+- `%USERPROFILE%\.config\servercommander\config.toml`
+- Override per `SERVERCOMMANDER_CONFIG`
+
+Die Sprache kann über `[server].language`, `SERVERCOMMANDER_LANG` oder `SERVERCOMMANDER_LOCALE` gesetzt werden.
+
+```toml
+[server]
+name = "ellmos-servercommander"
+language = "de" # en, de, es, zh, ja, ru
+```
+
+Secrets sollen als Umgebungsvariablen referenziert werden, zum Beispiel `$MAIL_PASSWORD` oder `$SFTP_PASSWORD`.
+
+## Tools
+
+- `sc_health_check`: prüft HTTP-Endpunkte und meldet Status-Code plus Latenz
+- `sc_logs_analyze`: analysiert Apache-/Nginx-Access-Logs aus Text oder Datei
+- `sc_deploy`: erstellt einen Deployment-Plan mit lokalem SHA256-Manifest, führt aber noch keinen Upload aus
+- `sc_deploy_status`: zeigt konfigurierte Deploy-Profile und den aktuellen Alpha-History-Status
+- `sc_mail_list`, `sc_mail_read`, `sc_mail_send`, `sc_mail_search`: sichere Alpha-Statusantworten ohne IMAP/SMTP-Verbindung
+
+## Entwicklung
+
+```powershell
+$env:PYTHONIOENCODING = "utf-8"
+$env:PYTHONDONTWRITEBYTECODE = "1"
+python -m pytest -q
+npm run smoke
+npm pack --dry-run
+```
+
+Der nächste sinnvolle Schritt ist die Extraktion der echten SFTP-, IMAP/SMTP- und erweiterten Traffic-Module aus `.UMBRUCH` in credential-freie Adapter mit lokalen Tests.

package/config/servercommander.example.toml

@@ -1,17 +1,19 @@
-# ellmos-servercommander-mcp — Konfiguration
-# Kopieren nach ~/.servercommander/config.toml und anpassen.
+# ellmos-servercommander-mcp configuration
+# Copy to ~/.servercommander/config.toml and adjust.
 
 [server]
 name = "ellmos-servercommander"
+# Tool metadata language: en, de, es, zh, ja, ru
+language = "en"
 
-# --- Deploy-Profile ---
+# --- Deploy profiles ---
 [deploy.profiles.example_site]
 host = "sftp.example.com"
 user = "deploy-user"
 remote_path = "/var/www/example"
 local_path = "./dist"
 protocol = "sftp"
-# password = "$SFTP_PASSWORD"    # Env-Variable referenzieren
+# password = "$SFTP_PASSWORD"    # Use environment variables for secrets.
 
 # [deploy.profiles.other]
 # host = "..."
@@ -26,11 +28,11 @@ username = "$MAIL_USER"
 password = "$MAIL_PASSWORD"
 cache_db = "~/.servercommander/mail_cache.db"
 
-# --- Log-Analyse ---
+# --- Log analysis ---
 [logs]
 default_format = "apache"   # apache | nginx
 
-# --- Health-Checks ---
+# --- Health checks ---
 [health]
 timeout = 5
 endpoints = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ellmos-servercommander-mcp",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Alpha MCP server for server operations: deploy dry-runs, mail status, log analysis, and health checks.",
   "type": "commonjs",
   "license": "MIT",
@@ -17,10 +17,12 @@
     "ellmos-servercommander": "bin/ellmos-servercommander.js"
   },
   "files": [
+    "assets/",
     "bin/",
     "config/",
     "src/",
     "README.md",
+    "README_de.md",
     "KONZEPT.md",
     "pyproject.toml"
   ],
@@ -29,6 +31,7 @@
     "server",
     "deploy",
     "logs",
+    "i18n",
     "health-checks",
     "ellmos"
   ],

package/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ellmos-servercommander-mcp"
-version = "0.1.0"
+version = "0.1.0a3"
 description = "MCP server for server operations: deploy, mail, log analysis, health checks."
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
 authors = [{ name = "Lukas Geiger" }]
-keywords = ["mcp", "deploy", "server-management", "ellmos"]
+keywords = ["mcp", "deploy", "server-management", "i18n", "ellmos"]
 dependencies = [
     "mcp>=1.0.0",
 ]

package/src/servercommander/__init__.py

@@ -1,3 +1,3 @@
-"""ellmos-servercommander-mcp — Server operations via MCP."""
+"""ellmos-servercommander-mcp - server operations via MCP."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.0a3"

package/src/servercommander/config.py

@@ -22,6 +22,7 @@ DEFAULT_CONFIG_PATHS = [
 @dataclass
 class ServerCommanderConfig:
     server_name: str = "ellmos-servercommander"
+    language: str = "en"
     deploy_profiles: dict[str, dict[str, Any]] = field(default_factory=dict)
     mail: dict[str, Any] = field(default_factory=dict)
     logs: dict[str, Any] = field(default_factory=dict)
@@ -45,7 +46,7 @@ def load_config(path: str | Path | None = None) -> ServerCommanderConfig:
                     break
 
     if path is None or not Path(path).exists():
-        return ServerCommanderConfig()
+        return ServerCommanderConfig(language=_env_language("en"))
 
     with open(path, "rb") as f:
         raw = tomllib.load(f)
@@ -53,9 +54,11 @@ def load_config(path: str | Path | None = None) -> ServerCommanderConfig:
     deploy = raw.get("deploy", {})
     profiles = deploy.get("profiles", {}) if isinstance(deploy, dict) else {}
     server = raw.get("server", {})
+    language = _env_language(server.get("language") or server.get("locale") or "en")
 
     return ServerCommanderConfig(
         server_name=server.get("name", "ellmos-servercommander"),
+        language=language,
         deploy_profiles=profiles if isinstance(profiles, dict) else {},
         mail=raw.get("mail", {}),
         logs=raw.get("logs", {}),
@@ -69,3 +72,7 @@ def resolve_env_value(value: Any) -> Any:
     if isinstance(value, str) and value.startswith("$") and len(value) > 1:
         return os.environ.get(value[1:], "")
     return value
+
+
+def _env_language(default: str) -> str:
+    return os.environ.get("SERVERCOMMANDER_LANG") or os.environ.get("SERVERCOMMANDER_LOCALE") or default

package/src/servercommander/i18n.py

@@ -0,0 +1,98 @@
+"""Locale helpers for ServerCommander MCP tool metadata."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+DEFAULT_LOCALE = "en"
+SUPPORTED_LOCALES = ("en", "de", "es", "zh", "ja", "ru")
+
+ALIASES = {
+    "en-us": "en",
+    "en-gb": "en",
+    "de-de": "de",
+    "de-at": "de",
+    "de-ch": "de",
+    "es-es": "es",
+    "es-mx": "es",
+    "zh-cn": "zh",
+    "zh-hans": "zh",
+    "ja-jp": "ja",
+    "ru-ru": "ru",
+}
+
+TRANSLATIONS: dict[str, dict[str, str]] = {
+    "de": {
+        "tool.sc_deploy": "Erstellt einen sicheren Deployment-Plan. Alpha: Ausführung nur als Dry-run.",
+        "tool.sc_deploy_status": "Zeigt konfigurierte Deployment-Profile und Alpha-History-Status.",
+        "tool.sc_mail_list": "Alpha-Mail-Status für das Auflisten eines IMAP-Ordners.",
+        "tool.sc_mail_read": "Alpha-Mail-Status für das Lesen einer Nachricht.",
+        "tool.sc_mail_send": "Alpha-Mail-Status für das Senden einer E-Mail; sendet noch nicht.",
+        "tool.sc_mail_search": "Alpha-Mail-Status für die Mail-Suche.",
+        "tool.sc_logs_analyze": "Analysiert Apache-/Nginx-Access-Logs aus Text oder Datei.",
+        "tool.sc_health_check": "Prüft HTTP-Endpunkte und meldet Status-Codes plus Latenz.",
+    },
+    "es": {
+        "tool.sc_deploy": "Crea un plan de despliegue seguro. Alpha: solo dry-run.",
+        "tool.sc_deploy_status": "Muestra perfiles de despliegue y estado de historial alpha.",
+        "tool.sc_mail_list": "Estado alpha para listar una carpeta IMAP.",
+        "tool.sc_mail_read": "Estado alpha para leer un mensaje.",
+        "tool.sc_mail_send": "Estado alpha para enviar correo; aún no envía.",
+        "tool.sc_mail_search": "Estado alpha para buscar correo.",
+        "tool.sc_logs_analyze": "Analiza logs de acceso Apache/Nginx desde texto o archivo.",
+        "tool.sc_health_check": "Comprueba endpoints HTTP y devuelve código de estado y latencia.",
+    },
+    "zh": {
+        "tool.sc_deploy": "创建安全部署计划。Alpha 版仅支持 dry-run。",
+        "tool.sc_deploy_status": "显示部署配置和 Alpha 历史状态。",
+        "tool.sc_mail_list": "用于列出 IMAP 文件夹的 Alpha 邮件状态。",
+        "tool.sc_mail_read": "用于读取邮件的 Alpha 状态。",
+        "tool.sc_mail_send": "用于发送邮件的 Alpha 状态；当前不会真正发送。",
+        "tool.sc_mail_search": "用于搜索邮件的 Alpha 状态。",
+        "tool.sc_logs_analyze": "从文本或文件分析 Apache/Nginx 访问日志。",
+        "tool.sc_health_check": "检查 HTTP 端点并返回状态码和延迟。",
+    },
+    "ja": {
+        "tool.sc_deploy": "安全なデプロイ計画を作成します。Alpha では dry-run のみです。",
+        "tool.sc_deploy_status": "設定済みデプロイプロファイルと Alpha 履歴状態を表示します。",
+        "tool.sc_mail_list": "IMAP フォルダ一覧用の Alpha メール状態を返します。",
+        "tool.sc_mail_read": "メッセージ読み取り用の Alpha メール状態を返します。",
+        "tool.sc_mail_send": "メール送信用の Alpha 状態を返します。まだ送信しません。",
+        "tool.sc_mail_search": "メール検索用の Alpha 状態を返します。",
+        "tool.sc_logs_analyze": "テキストまたはファイルから Apache/Nginx アクセスログを分析します。",
+        "tool.sc_health_check": "HTTP エンドポイントを確認し、ステータスコードとレイテンシを返します。",
+    },
+    "ru": {
+        "tool.sc_deploy": "Создает безопасный план деплоя. Alpha: только dry-run.",
+        "tool.sc_deploy_status": "Показывает профили деплоя и alpha-статус истории.",
+        "tool.sc_mail_list": "Alpha-статус для просмотра папки IMAP.",
+        "tool.sc_mail_read": "Alpha-статус для чтения сообщения.",
+        "tool.sc_mail_send": "Alpha-статус отправки почты; пока не отправляет.",
+        "tool.sc_mail_search": "Alpha-статус поиска почты.",
+        "tool.sc_logs_analyze": "Анализирует access-логи Apache/Nginx из текста или файла.",
+        "tool.sc_health_check": "Проверяет HTTP endpoints и возвращает коды статуса и задержку.",
+    },
+}
+
+
+def normalize_locale(locale: str | None) -> str:
+    if not locale:
+        return DEFAULT_LOCALE
+    normalized = locale.strip().lower().replace("_", "-")
+    normalized = ALIASES.get(normalized, normalized.split("-", 1)[0])
+    if normalized in SUPPORTED_LOCALES:
+        return normalized
+    return DEFAULT_LOCALE
+
+
+@dataclass(frozen=True)
+class I18n:
+    locale: str = DEFAULT_LOCALE
+
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "locale", normalize_locale(self.locale))
+
+    def t(self, key: str, default: str | None = None) -> str:
+        if self.locale == DEFAULT_LOCALE:
+            return default or key
+        return TRANSLATIONS.get(self.locale, {}).get(key) or default or key

package/src/servercommander/server.py

@@ -15,6 +15,7 @@ from mcp.server.stdio import stdio_server
 from servercommander.config import ServerCommanderConfig, load_config
 from servercommander.deploy import sc_deploy, sc_deploy_status
 from servercommander.health import sc_health_check
+from servercommander.i18n import I18n
 from servercommander.logs import sc_logs_analyze
 from servercommander.mail import sc_mail_list, sc_mail_read, sc_mail_search, sc_mail_send
 from servercommander.tooling import ToolDefinition
@@ -31,9 +32,17 @@ class ServerCommanderRegistry:
         self.config = config
         self._tools = build_tools(config)
         self._handlers = {tool.name: tool.handler for tool in self._tools}
+        self.i18n = I18n(config.language)
 
     def list_tools(self) -> list[types.Tool]:
-        return [tool.as_mcp_tool() for tool in self._tools]
+        return [
+            types.Tool(
+                name=tool.name,
+                description=self.i18n.t(f"tool.{tool.name}", tool.description),
+                inputSchema=tool.input_schema,
+            )
+            for tool in self._tools
+        ]
 
     async def call_tool(self, name: str, arguments: dict[str, Any] | None = None) -> dict[str, Any]:
         handler = self._handlers.get(name)