shellserver

Python MCP SDK (FastMCP)로 구축된 소규모 Model Context Protocol (MCP) 서버입니다. 서버 프로세스가 실행되는 머신에서 셸 명령을 실행하는 도구 하나를 제공합니다.

요구 사항

• Python 3.14+ (pyproject.toml 참조)

• 의존성 설치 및 실행을 위한 uv

Related MCP server: Shell MCP Server

설정

이 저장소를 복제하거나 복사한 후, 프로젝트 루트에서 다음을 수행하세요:

uv sync

서버 실행

이 서버는 stdio 전송( FastMCP의 기본값)을 사용합니다.

uv run python server.py

서버 프로세스에서 stdout으로 추가 데이터를 파이프하지 마십시오. MCP는 JSON-RPC를 위해 stdout을 사용합니다. server.py의 로깅은 stderr로 전달됩니다.

도구: terminal_tool

이 도구는 exit_code, stdout, stderr를 포함하는 단일 텍스트 블록을 반환합니다. 명령이 시간 제한을 초과하면 프로세스가 종료되고 응답에 시간 초과가 표시됩니다.

클라이언트 연결 (로컬 실행 예시)

이 프로젝트를 작업 디렉터리로 설정하여 MCP 호스트를 uv로 지정하십시오. 구성 예시:

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

사용 중인 편집기나 클라이언트에 맞춰 키 이름과 cwd를 조정하십시오.

보안

이 서버는 호스트에서 임의의 셸 명령을 실행합니다. 이 서버에 대해 MCP 도구를 호출할 수 있는 사람은 누구나 해당 머신에 대한 셸 접근 권한을 갖게 됩니다. 신뢰할 수 있는 호스트와 클라이언트에서만 사용하고, 위험성을 명확히 이해한 상태에서 사용하십시오.