Docker를 사용한 로컬(stdio) MCP 서버

이 프로젝트는 stdio를 통해 run_command 도구를 노출하는 최소한의 로컬 MCP 서버입니다.

설정

cd ~path-to-directory/local-mcp-with-docker
uv sync

다음을 사용하여 스크립트를 시작합니다:

uv run main.py

참고: MCP 2.0부터는 서버 시작 후 콘솔에 출력이 없습니다. 프로세스는 계속 실행되며 MCP 클라이언트의 stdio 메시지를 기다립니다. 새 터미널 세션에서 디버거를 사용하여 검사할 수 있습니다.

인스펙터 시작:

npx -y @modelcontextprotocol/inspector

그런 다음 인스펙터 UI에서:

• Transport: stdio

• Command: uv

• Args: run, python, main.py

• Working directory: ~path-to-directory/local-mcp-with-docker

인스펙터는 등록된 도구 run_command를 표시하고 직접 호출할 수 있게 해야 합니다.

Related MCP server: mcp-stdio

Docker 이미지 빌드

docker build -t terminal_tool_docker .

이렇게 하면 Claude Desktop MCP 구성에서 사용하는 로컬 Docker 이미지가 생성됩니다.

Claude Desktop 구성

Claude Desktop MCP 구성 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "local-mcp-with-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "-e",
        "WORKSPACE_DIR=/root/mcp/workspace",
        "-v",
        "path-to-directory/local-mcp-with-docker:/root/mcp/workspace",
        "terminal_tool_docker"
      ]
    }
  }
}

이렇게 하면 작업 공간이 컨테이너에 마운트되고 서버가 컨테이너 내부의 올바른 작업 디렉터리를 가리키게 됩니다.

Claude 스크린샷