ellmos-servercommander-mcp

サーバー操作用のアルファ版MCPサーバー：デプロイメントのドライラン、メールステータス、アクセスログ分析、HTTPヘルスチェック。

ドイツ語版README: README_de.md

ellmos-ai ファミリーの一部。

[!NOTE] 発見可能性 & AI検索: npm に ellmos-servercommander-mcp として公開され、server.json、glama.json、smithery.yaml でMCPエコシステム向けにカタログ化され、llms.txt でAI/LLM検索向けにインデックス化されています。

アーキテクチャの可視化

graph TD
    Client[MCP Host: Claude / Cursor] <-->|stdio / JSON-RPC| NodeWrapper[Node.js Entrypoint]
    NodeWrapper <-->|Spawn subprocess| PyServer[Python MCP Server]
    
    subgraph Tools [ServerCommander Tools]
        PyServer -->|sc_health_check| HTTP[HTTP/HTTPS Endpoint Check]
        PyServer -->|sc_logs_analyze| Logs[Apache/Nginx Access Logs]
        PyServer -->|sc_deploy / sc_deploy_status| Deploy[Dry-Run Manifest & SQLite History]
        PyServer -->|sc_mail_*| Mail[IMAP/SMTP Safe Readiness Diagnostics]
    end
    
    subgraph Storage [Local Storage]
        Deploy -->|Optional persist| SQLite[(SQLite Deploy History)]
        Logs -->|Optional persist| JSONReports[(JSON Log Reports)]
    end

Related MCP server: automation-health-mcp

はじめに

ステータス

• トランスポート: Python MCP SDK 経由の stdio

• パッケージステータス: ellmos-ai 配下のパブリックアルファパッケージ

• 現在のコア: MCPツール一覧、MCPツールディスパッチ、設定読み込み、HTTPヘルスチェック、オプションで永続化されたJSONレポート付きの強化されたアクセスログ分析、オプションのローカルドライランデプロイ履歴

• 安全なアルファハンドラ: sc_deploy はローカルのSHA256マニフェスト、設定診断、ドライランモードでのオプトインSQLite履歴レコードを構築します。sc_mail_* はメール接続を開かずにプロトコル固有のIMAP/SMTP準備状態を報告します。

• i18n: en、de、es、zh、ja、ru 向けのローカライズされたMCPツール説明、入力スキーマフィールド説明、不明なツールエラー（英語フォールバック付き）

インストール

npmパッケージにはPythonサーバーを起動するNodeラッパーが含まれています。Python 3.10+ と Python パッケージ mcp>=1.0.0 が依然として必要です。

オプション1: npmからインストール

npm install -g ellmos-servercommander-mcp@alpha
ellmos-servercommander

オプション2: ソースからインストール

git clone https://github.com/ellmos-ai/ellmos-servercommander-mcp.git
cd ellmos-servercommander-mcp
$env:PYTHONIOENCODING = "utf-8"
python -m pip install -e ".[dev]"
python -m pytest -q

同期クライアントがファイルをロックする場合は、クラウド同期フォルダ内に .venv を作成しないでください。分離された環境が必要な場合は、そのフォルダの外に作成してください。

ソースから起動

$env:PYTHONPATH = "src"
python -m servercommander.server

MCPクライアント設定

グローバルnpmインストール

{
  "mcpServers": {
    "servercommander": {
      "command": "ellmos-servercommander"
    }
  }
}

グローバルインストールなしのnpx

{
  "mcpServers": {
    "servercommander": {
      "command": "npx",
      "args": ["-y", "ellmos-servercommander-mcp@alpha"]
    }
  }
}

Pythonの直接実行

{
  "mcpServers": {
    "servercommander": {
      "command": "python",
      "args": ["-m", "servercommander.server"],
      "env": {
        "PYTHONPATH": "C:/path/to/ellmos-servercommander-mcp/src",
        "SERVERCOMMANDER_CONFIG_PATH": "C:/path/to/config/servercommander.toml"
      }
    }
  }
}

設定

ServerCommander は以下の順序で設定を探します：

1. 環境変数 SERVERCOMMANDER_CONFIG_PATH

2. ./servercommander.toml

3. ./config/servercommander.toml

4. ~/.config/servercommander/servercommander.toml

注釈付きテンプレートが config/servercommander.example.toml に含まれています。

[server]
name = "servercommander"
log_level = "INFO"
language = "en"

[deploy.profiles.staging]
target = "sftp://staging.example.com/var/www/app"
local_path = "./dist"
protocol = "sftp"
dry_run = true
record_history = true

[mail]
execution_enabled = false
smtp_host = "smtp.example.com"
smtp_port = 587
imap_host = "imap.example.com"
imap_port = 993

シークレットは環境変数（例：$MAIL_PASSWORD や $SFTP_PASSWORD）を介して参照する必要があります。

ツール

• sc_health_check: HTTPエンドポイントをチェックし、ステータスコードとレイテンシを返します。不正な形式のエンドポイントURLは失敗したチェックとして返されるため、1つの不正な入力でバッチ全体が中断されることはありません。

• sc_logs_analyze: インラインテキストまたはローカルファイルからApache/Nginxアクセスログを分析します。ステータスクラス、バイト数、リファラー、エラーパス、不審なリクエストマーカー、および persist_report によるオプションのJSONレポート永続化を含みます。

• sc_deploy: ローカルのSHA256マニフェストとプロファイル診断を含むデプロイ計画を作成しますが、まだアップロードは行いません。準備状態チェックでは、オプションの record_history=true の前に、必須フィールド、マニフェスト可能なローカルパス、サポートされているプロトコルを確認します。ネストされたシンボリックリンクは報告されますが除外されるため、マニフェストが選択されたリリースディレクトリを超えて静かにトラバースすることはできません。

• sc_deploy_status: 設定されたデプロイプロファイル、選択されたプロファイルの診断、およびローカルのSQLite履歴データベースからの最近のドライラン履歴を表示します。

• sc_mail_list、sc_mail_read、sc_mail_send、sc_mail_search: アクション固有のIMAP/SMTP準備状態診断を含み、デフォルトではメール接続を行わない安全なアルファステータス応答。[mail].execution_enabled = true の場合、sc_mail_list は正規の mail-connector モジュールを再利用して、ライブの読み取り専用IMAP到達可能性プローブ（接続 + フォルダ一覧）を実行します。IMAPクライアントを再実装するわけではありません。メッセージレベルの読み取り/検索は mail-connector の領域であり、SMTP送信は実行されないままです。

検索と曖昧性解消

ServerCommander は、ローカルファーストのサーバー管理ワークフローのための ellmos オペレーションズMCPサーバーです。以下のものを検索する際にこのリポジトリを使用してください：

• MCPサーバー運用ツール

• MCPデプロイドライランサーバー

• MCPアクセスログアナライザー

• MCP HTTPヘルスチェックツール

• ローカルファーストサーバー管理MCP

• Claude Codeサーバー運用MCP

• 安全なSFTPデプロイ計画MCP

これはGitHub MCPサーバーではなく、汎用シェルコマンドMCPサーバーでも、ホスティングプロバイダーコントロールパネルでも、本番SFTP/IMAP実行ツールでもありません。現在のアルファ版の表面は、意図的に診断とドライランを優先しています。

ellmos-ai エコシステム

このMCPサーバーは ellmos-ai エコシステムの一部です — AIインフラストラクチャ、MCPサーバー、インテリジェントツール。

MCPサーバーファミリー

AIインフラストラクチャ & 開発者ツール

デスクトップソフトウェア

私たちのパートナー組織 open-bricks は、AIネイティブのデスクトップアプリケーションをバンドルしています。AI時代に合わせて構築されたモダンでオープンソースのソフトウェアスイートです。カテゴリには、ファイル管理（ProFiler）、ドキュメントツール（DokuZen、PDFtoPDFocr）、開発者ユーティリティ（DevCenter、CodeBox）などが含まれます。

開発

$env:PYTHONIOENCODING = "utf-8"
python -m pytest -q
npm run smoke
npm pack --dry-run

次の有用なステップ：ドライラン/ステータスのみのデフォルトを維持しながら、SFTPおよびIMAP/SMTP用の明示的に設定された実行アダプターを追加します。