Quay MCP Server

A Model Context Protocol (MCP) server that provides access to Quay container registry APIs. This server automatically discovers Quay API endpoints from the OpenAPI specification and generates MCP tools for interacting with Quay registries.

Project Structure

This project follows Go best practices with a clean, modular architecture:

quay-mcp-server/
├── cmd/
│   └── quay-mcp/           # Main application
│       └── main.go
├── internal/               # Private application code
│   ├── client/            # Quay API client
│   │   └── quay_client.go
│   ├── server/            # MCP server implementation
│   │   └── mcp_server.go
│   └── types/             # Common data types
│       └── types.go
├── examples/              # Example code and demonstrations
│   └── example.go
├── test/                  # Test files
│   └── main_test.go
├── testing/               # Test data and fixtures
├── bin/                   # Built binaries (created by build)
├── go.mod                 # Go module definition
├── go.sum                 # Go module checksums
├── Makefile              # Build automation
├── README.md             # This file
└── .gitignore            # Git ignore rules

Features

• Automatic API Discovery: Fetches and parses Quay's OpenAPI specification
• Dynamic Tool Generation: Creates MCP tools from API endpoints
• Smart Parameter Handling: Supports both path and query parameters
• Comprehensive Logging: Detailed request/response logging with security features
• Tag-based Filtering: Only exposes relevant API endpoints (manifest, organization, repository, robot, tag)
• Authentication Support: OAuth token authentication for protected resources

Installation

Prerequisites

• Go 1.23 or later
• Access to a Quay registry (e.g., quay.io)

Building from Source

# Clone the repository
git clone https://github.com/quay/quay-mcp-server.git
cd quay-mcp-server

# Install dependencies
make deps

# Build the application
make build

# The binary will be available at ./bin/quay-mcp

Using Make Commands

# Build the application
make build

# Run tests
make test

# Run example mode
make run-example

# Clean build artifacts
make clean

# Format code
make fmt

# Install to GOPATH/bin
make install

# Show all available commands
make help

Usage

Basic Usage

# Start MCP server for quay.io
./bin/quay-mcp -url https://quay.io

# Start with OAuth token for authenticated access
./bin/quay-mcp -url https://quay.io -token your-oauth-token

# Run in example mode to see available tools
./bin/quay-mcp -url https://quay.io -example

Command Line Options

• -url <registry-url>: Quay registry URL (required)
• -token <oauth-token>: OAuth token for authentication (optional)
• -example: Run in example mode to demonstrate functionality

Integration with Claude Desktop

Add the following to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "quay": {
      "command": "/path/to/bin/quay-mcp",
      "args": ["-url", "https://quay.io"],
      "env": {
        "QUAY_OAUTH_TOKEN": "your-oauth-token-here"
      }
    }
  }
}

Integration with MCPHost

MCPHost is a powerful CLI host application that enables Large Language Models (LLMs) to interact with MCP servers. You can use it to interact with your Quay registry through various LLM providers.

Installation

Install MCPHost using one of these methods:

# Using Go
go install github.com/mark3labs/mcphost@latest

# Using npm
npm install -g @mark3labs/mcphost

# Or download from releases
# https://github.com/mark3labs/mcphost/releases

Configuration

Create or update your MCPHost configuration file at ~/.mcphost.yml:

# MCP Servers configuration
mcpServers:
  quay:
    command: "/path/to/bin/quay-mcp"
    args: ["-url", "https://quay.io"]
    env:
      QUAY_OAUTH_TOKEN: "your-oauth-token-here

... [View full README on GitHub](https://github.com/quay/quay-mcp-server#readme)