config.local.yaml.example

# config.local.yaml.example — template for machine-specific config overrides.
#
# The repository already tracks `config.local.yaml` as an empty `{}` fallback.
# Add deployment/host-specific settings there as an uncommitted local edit — e.g.
# MCP servers whose `command:` is an absolute path under your home directory.
#
# Activation is already in the tracked config.yaml:
#     include: ["config.local.yaml"]
#
# litellm merges included files into the main config. Caveats:
#   - the included file is supplied as a tracked empty mapping so fresh checkouts
#     start normally;
#   - a key whose value is a dict (e.g. `mcp_servers`) REPLACES the main config's
#     value rather than deep-merging — so list EVERY MCP server you want under
#     `mcp_servers` here, including any you still want from config.yaml (e.g. the
#     bundled `newscatcher`), or it is dropped at runtime.
#
# Two more litellm rules for stdio MCP `command`/`args` (see docs/guide/mcp-servers.md):
#   - NO variable expansion: ${HOME} / ~ / $VAR are taken literally. Use absolute paths.
#   - Command allowlist: only basenames in {deno,docker,node,npx,python,python3,uvx}
#     are allowed. A venv `.../bin/python` passes (basename `python`); a custom
#     launcher (e.g. `ado-mcp`) must be added to LITELLM_MCP_STDIO_EXTRA_COMMANDS
#     in .env.
#
# Example (replace /home/you with your real absolute home path):
#
# mcp_servers:
#   # Script with its own venv — interpreter basename `python` is allow-listed.
#   my_local_tool:
#     transport: stdio
#     command: /home/you/projects/my-tool/.venv/bin/python
#     args: ["/home/you/projects/my-tool/mcp-server/server.py"]
#     env:
#       MY_TOOL_TOKEN: os.environ/MY_TOOL_TOKEN
#
#   # Custom launcher binary — also requires, in .env:
#   #     LITELLM_MCP_STDIO_EXTRA_COMMANDS=ado-mcp
#   ado_mcp:
#     transport: stdio
#     command: /home/you/projects/ado-mcp/.venv/bin/ado-mcp
#     args: ["--profile", "full"]
#     env:
#       ADO_ORG_URL: os.environ/ADO_ORG_URL
#       ADO_PAT: os.environ/ADO_PAT
#
#   # Re-list bundled servers you still want (dict REPLACE, not merge).
#   newscatcher:
#     transport: stdio
#     command: python3
#     args: ["-m", "airlock.mcp_servers.newscatcher_server"]
#     env:
#       NEWS_CATCHER_API_KEY: os.environ/NEWS_CATCHER_API_KEY