orbstack_docker_pull
Idempotent
Pull Docker images from container registries to your local system using the OrbStack MCP Server. Specify the image name to download and prepare containers for deployment.
Instructions
从镜像仓库拉取 Docker 镜像。
Args: params: 包含镜像名称
Returns: str: 拉取结果
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
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",