Skip to content

docker mcp server inspect fails for custom catalog entries (not found in catalog) #393

@loup-peluso

Description

@loup-peluso

Summary
When a server is defined in a custom catalog (local YAML), docker mcp server inspect <name> returns
“server "" not found in catalog”, even though:

  • docker mcp catalog show <catalog> lists it
  • docker mcp server ls shows it enabled
  • docker mcp gateway run reads both catalogs and actually launches the container

This suggests server inspect is not resolving custom catalogs.

Steps to Reproduce

  1. docker mcp catalog init
  2. Create a custom catalog file (example below) and import it:
    docker mcp catalog import <HOME>/.docker/mcp/catalogs/personal.yaml
  3. Ensure config exists (any value is fine):
    <HOME>/.docker/mcp/config.yaml:
    gmail-mcp:
      email_address: "<EMAIL>"
  4. Enable the custom server:
    docker mcp server enable gmail-autoauth
  5. Inspect:
    docker mcp server inspect gmail-autoauth

Expected
docker mcp server inspect gmail-autoauth returns tool/schema/metadata (like inspect does for official catalog entries).

Actual
docker mcp server inspect gmail-autoauth returns:
server "gmail-autoauth" not found in catalog

Custom catalog example (personal.yaml)

version: 3
name: personal
displayName: Personal Catalog
registry:
  gmail-autoauth:
    title: Gmail AutoAuth
    description: Gmail MCP server with auto authentication support
    type: server
    image: node:20-alpine
    command:
      - npx
      - -y
      - "@gongrzhe/server-gmail-autoauth-mcp@1.1.11"
    env:
      - name: EMAIL_ADDRESS
        value: '{{gmail-mcp.email_address}}'
    volumes:
      - "<HOME>/.gmail-mcp:/root/.gmail-mcp:ro"
    config:
      - name: gmail-mcp
        description: Configure Gmail AutoAuth
        type: object
        properties:
          email_address:
            type: string
            description: Your Gmail email address
        required:
          - email_address

Evidence that gateway sees it
Running docker mcp gateway run logs:

  • Reading catalog from [docker-mcp.yaml personal.yaml]
  • Those servers are enabled: context7, gmail-autoauth
  • Running node:20-alpine ... command [npx -y @gongrzhe/server-gmail-autoauth-mcp@1.1.11]

Environment

  • macOS 26.2 (arm64)
  • Docker Desktop 4.60.0
  • Docker CLI 29.2.0
  • docker mcp v0.38.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions