ORAS MCP Server

@shizhMSFT

Repository Homepage

Basic information

About ORAS MCP Server

ORAS MCP Server

#docker #registry #storage #oci #artifact

ORAS MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "oras-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/oras-project/oras-mcp:main",
        "serve"
      ]
    }
  }
}

ORAS MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ORAS MCP Server?

ORAS MCP Server is an MCP server that enables registry-aware chat interactions within VS Code agent mode. It uses the oras-go library to query OCI-compliant registries and does not depend on the oras CLI. It is designed for developers who want to ask questions about container images and their metadata during coding sessions.

How to use ORAS MCP Server?

Configure the server in .vscode/mcp.json either by running the Docker image (ghcr.io/oras-project/oras-mcp:main serve) or by downloading a released binary and pointing the command to oras-mcp serve. Authentication uses credentials from Docker or ORAS login; on Linux the Docker config can be mounted for container use, while macOS/Windows require the binary.

Key features of ORAS MCP Server

Integrates with VS Code agent mode for registry-aware chats.
Uses oras-go library; no dependency on the ORAS CLI.
Supports querying image platforms, signatures, and metadata.
Two deployment options: Docker container or standalone binary.
Reads credentials from existing Docker and ORAS credential stores.

Use cases of ORAS MCP Server

Ask “What platforms does image ghcr.io/oras-project/oras support?” and get a list.
Find the latest tag of an image in a registry and whether it has a signature.
Determine the signature type (e.g., Notary v2) of a container image.
Explore registry content without leaving the VS Code coding environment.

Frequently asked questions

How do I authenticate to a registry?

Run `oras login` or `docker login` on the host machine. The released binary picks up cached credentials automatically. For the Docker container on Linux, mount the Docker config file with inline `auths` entries; helper-based configs (`credsStore`, `credHelpers`) will not work.

Why can't I use the Docker container on macOS or Windows?

Docker Desktop on macOS and Windows depends on keychain helpers, which are not supported

Comments

More Other MCP servers

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K