OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:870-885 (handler)

  The 'orbstack_docker_pull' handler executes the docker pull command.

  async def orbstack_docker_pull(params: DockerImageInput) -> str:
      """从镜像仓库拉取 Docker 镜像。
  
      Args:
          params: 包含镜像名称
  
      Returns:
          str: 拉取结果
      """
      code, stdout, stderr = await _run_docker(["pull", params.image], timeout=300)
      if code != 0:
          return _format_error(stderr, "请检查镜像名称是否正确")
      return f"镜像 '{params.image}' 拉取成功\n{stdout}"
  
  
  @mcp.tool(

• src/orbstack_mcp/server.py:860-869 (registration)

  The 'orbstack_docker_pull' tool registration using the @mcp.tool decorator.

  @mcp.tool(
      name="orbstack_docker_pull",
      annotations={
          "title": "拉取 Docker 镜像",
          "readOnlyHint": False,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": True,
      },
  )

• src/orbstack_mcp/server.py:260-266 (schema)

  The input schema for 'orbstack_docker_pull' defined as DockerImageInput.

  class DockerImageInput(BaseModel):
      """Docker 镜像相关输入"""
      model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
  
      image: str = Field(
          ...,
          description="镜像名称，如 nginx:latest, ubuntu:22.04",