config

# View entire configuration
docs-mcp-server config [options]

# Get specific value
docs-mcp-server config get <path> [options]

# Set configuration value
docs-mcp-server config set <path> <value>

docs-mcp-server config [options]

docs-mcp-server config get <path> [options]

docs-mcp-server config set <path> <value>

# View entire config (JSON)
docs-mcp-server config

# View entire config (YAML)
docs-mcp-server config --yaml

{
  "app": {
    "storePath": "/Users/me/.local/share/docs-mcp-server",
    "telemetryEnabled": true,
    "readOnly": false,
    "embeddingModel": "openai:text-embedding-3-small"
  },
  "scraper": {
    "maxPages": 1000,
    "maxDepth": 10,
    "maxConcurrency": 5
  },
  "server": {
    "protocol": "auto",
    "host": "localhost",
    "ports": {
      "default": 8080,
      "worker": 8080,
      "mcp": 8081,
      "web": 8082
    }
  }
}

# Get scalar value (plain text output)
docs-mcp-server config get scraper.maxPages
# Output: 1000

# Get object value (JSON output)
docs-mcp-server config get scraper
# Output: {"maxPages": 1000, "maxDepth": 10, ...}

# Get with explicit format
docs-mcp-server config get scraper --yaml

# Set number
docs-mcp-server config set scraper.maxPages 2000
# Output: Updated scraper.maxPages = 2000

# Set boolean
docs-mcp-server config set app.telemetryEnabled false
# Output: Updated app.telemetryEnabled = false

# Set string
docs-mcp-server config set app.embeddingModel "vertex:text-embedding-004"
# Output: Updated app.embeddingModel = "vertex:text-embedding-004"

app.storePath                    # Data storage directory
app.telemetryEnabled             # Enable/disable telemetry
app.readOnly                     # Read-only mode
app.embeddingModel               # Default embedding model

scraper.maxPages                 # Maximum pages to scrape
scraper.maxDepth                 # Maximum crawl depth
scraper.maxConcurrency           # Concurrent requests
scraper.document.maxSize         # Max document size (bytes)
scraper.document.minSize         # Min document size (bytes)

server.protocol                  # Protocol (auto, stdio, http)
server.host                      # Bind host
server.ports.default             # Default port
server.ports.worker              # Worker port
server.ports.mcp                 # MCP server port
server.ports.web                 # Web interface port

auth.enabled                     # Enable authentication
auth.issuerUrl                   # OAuth2/OIDC issuer URL
auth.audience                    # JWT audience claim

embeddings.vectorDimension       # Vector dimension size
embeddings.chunkSize             # Document chunk size
embeddings.chunkOverlap          # Chunk overlap size

# The config get command shows the path in debug logs
docs-mcp-server --verbose config get app.storePath

# Error: Cannot modify explicit config file
docs-mcp-server --config /path/to/config.yaml config set scraper.maxPages 2000
# ❌ Error: Cannot modify configuration when using explicit --config file.

# Solution: Remove --config to modify default config
docs-mcp-server config set scraper.maxPages 2000

# Numbers
config set scraper.maxPages 2000              # Parsed as: 2000
config set scraper.timeout 30.5               # Parsed as: 30.5

# Booleans
config set app.telemetryEnabled true          # Parsed as: true
config set app.telemetryEnabled false         # Parsed as: false

# Strings (quotes optional for simple strings)
config set app.embeddingModel openai:text-embedding-3-small
config set app.embeddingModel "openai:text-embedding-3-small"

# Arrays (JSON format)
config set scraper.excludePatterns '["*/blog/*","*.pdf"]'

docs-mcp-server config get invalid.path
# Error: Invalid config path 'invalid.path'
# Use 'docs-mcp-server config' to see all available paths.

docs-mcp-server config set scraper "value"
# Error: Config path 'scraper' refers to an object.
# Use a more specific leaf path to set a scalar value.
# Hint: Run 'docs-mcp-server config' to inspect the current structure.

docs-mcp-server --config /path/to/config.yaml config set scraper.maxPages 2000
# Error: Cannot modify configuration when using explicit --config file.
# Remove the --config flag to modify the default configuration.

# Environment variable overrides config file
export DOCS_MCP_SCRAPER_MAX_PAGES=2000
docs-mcp-server config get scraper.maxPages
# Output: 2000

# View full config with structure
docs-mcp-server config

# Extract all leaf paths (using jq)
docs-mcp-server config --json | jq -r 'paths(scalars) | join(".")'

app.storePath
app.telemetryEnabled
app.readOnly
app.embeddingModel
scraper.maxPages
scraper.maxDepth
scraper.maxConcurrency
server.protocol
server.host
server.ports.default
...