ORAS MCP Server

@shizhMSFT

About ORAS MCP Server

ORAS MCP Server

#docker #registry #storage #oci #artifact

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"
      ]
    }
  }
}

Tools

No tools detected

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.

FAQ from ORAS MCP Server

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

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

Basic information

More Other MCP servers

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K