feat(custom-mcp): add brave, wikipedia, postgres servers; secrets wiring; Taskfile targets

Author: Fadil369

custom-mcp/.mcp.env

@@ -0,0 +1,7 @@
+# Copy this file to .mcp.env and fill in the values you need
+# Common MCP servers
+GITHUB_TOKEN=
+DUCKDUCKGO_APP_NAME=docker-compose-for-agents
+
+# Optional Postgres example (if you enable postgres server)
+# POSTGRES_URL=postgres://user:password@host:5432/dbname

custom-mcp/README.md

@@ -22,6 +22,16 @@ Modify servers
 - Edit compose.yaml and add or remove `--servers=...` entries on the mcp-gateway service.
 - If a server needs credentials, add them to `.mcp.env` and reference via `--secrets=...` if required.
 
+Included servers & secrets
+- duckduckgo: No secret required (optional app name via DUCKDUCKGO_APP_NAME)
+- github-official: Requires GITHUB_TOKEN in .mcp.env
+- brave: Requires BRAVE_API_KEY in .mcp.env
+- wikipedia-mcp: No secret required
+- postgres with SQL query tool:
+  - Create a file named `postgres_url` in this directory containing the DSN, e.g.
+    postgres://user:password@host:5432/dbname
+  - This is mounted as a secret named `database-url` and used by the gateway.
+
 Notes
 - The example includes a minimal curl-based `mcp-client` container that checks gateway health.
 - To integrate with an agent, set its MCP server URL to the gateway endpoint, e.g. `http://mcp-gateway:8811/sse` for SSE transport.

custom-mcp/Taskfile.yaml

@@ -0,0 +1,27 @@
+version: "3"
+
+tasks:
+  up:
+    desc: Start custom MCP stack
+    cmds:
+      - docker compose up --build
+    dir: .
+
+  down:
+    desc: Stop and remove containers
+    cmds:
+      - docker compose down -v --remove-orphans
+    dir: .
+
+  build:
+    desc: Build images
+    cmds:
+      - docker compose build
+    dir: .
+
+  clean:
+    desc: Clean everything
+    cmds:
+      - docker compose down -v --remove-orphans
+      - docker builder prune -f
+    dir: .

custom-mcp/compose.yaml

@@ -17,15 +17,20 @@ services:
       - --transport=sse
       # secrets can be provided multiple times and referenced per server
       - --secrets=docker-desktop:/run/secrets/mcp_secret
+      # For Postgres DSN
+      - --secrets=/run/secrets/database-url
       # Enable the servers you need. Add/remove as desired.
       # Built-in servers supported by gateway include e.g. duckduckgo, github-official, postgres
       - --servers=duckduckgo
       - --servers=github-official
-      # Example Postgres tool (requires POSTGRES_URL in secrets)
-      # - --servers=postgres
-      # - --tools=query
+      - --servers=brave
+      - --servers=wikipedia-mcp
+      # Postgres server and SQL tool (requires database-url secret file)
+      - --servers=postgres
+      - --tools=query
     secrets:
       - mcp_secret
+      - database-url
 
 # Example model configuration if you want to co-run with Docker Model Runner
 # and point an agent to it. Not strictly required for MCP Gateway testing.
@@ -38,3 +43,5 @@ services:
 secrets:
   mcp_secret:
     file: ./.mcp.env
+  database-url:
+    file: ./postgres_url

custom-mcp/mcp.env.example

@@ -2,6 +2,8 @@
 # Common MCP servers
 GITHUB_TOKEN=
 DUCKDUCKGO_APP_NAME=docker-compose-for-agents
+BRAVE_API_KEY=
 
-# Optional Postgres example (if you enable postgres server)
-# POSTGRES_URL=postgres://user:password@host:5432/dbname
+# Postgres DSN is read from a separate secret file named "postgres_url" in this directory.
+# Example content:
+# postgres://user:password@host:5432/dbname