# MCP Nexus — example configuration (Phase 1).
#
# In Phase 1, upstream MCP servers are declared statically here. Later phases
# populate them automatically via Discovery + Recipes + the Installer.
#
# Environment variables in this file are expanded (e.g. ${HOME}, ${GH_TOKEN}).

server:
  # Address the aggregated MCP endpoint + ops routes listen on.
  address: ":8080"

gateway:
  name: "MCP Nexus"
  # Path the single aggregated MCP endpoint is served on.
  mcp_path: "/mcp"

upstreams:
  # Zero-dependency demo server built into the nexus binary. Great for a first
  # end-to-end test: exposes demo.echo, demo.add, demo.now.
  - namespace: demo
    transport: stdio
    command: nexus
    args: ["demo-mcp"]

  # Example: the official filesystem MCP server via npx (requires Node).
  # Uncomment to expose fs.* tools scoped to a directory.
  # - namespace: fs
  #   transport: stdio
  #   command: npx
  #   args: ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}"]

  # Example: a remote MCP server over Streamable HTTP.
  # - namespace: remote
  #   transport: http
  #   endpoint: "http://127.0.0.1:9000/mcp"
  #   headers:
  #     Authorization: "Bearer ${REMOTE_MCP_TOKEN}"