ellmos-servercommander-mcp

서버 운영을 위한 알파 MCP 서버: 배포 드라이런, 메일 상태, 액세스 로그 분석, HTTP 상태 점검.

독일어 README: README_de.md

ellmos-ai 제품군의 일부입니다.

[!NOTE] 발견성 및 AI 검색: server.json, glama.json, smithery.yaml에 MCP 생태계용으로 분류되어 npm에 ellmos-servercommander-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은 실패한 검사로 반환되므로 잘못된 입력 하나가 배치를 중단하지 않습니다

• 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

다음 유용한 단계: dry-run/status-only 기본값을 유지하면서 SFTP 및 IMAP/SMTP에 대한 명시적으로 구성된 실행 어댑터를 추가합니다.