DeepBlue Wiki & MCP Setup

The DeepBlue LLM Wiki runs at https://wiki.deepbluebase.xyz.

Services

Service	Port	File	Purpose
`deepblue-wiki-web`	3002	`wiki/webui/main.py`	Web UI (FastAPI + dark theme)
`deepblue-wiki-api`	4510	`wiki/api/main.py`	REST API for Claude/bots
`deepblue-wiki-mcp`	4511	`wiki/mcp/server.py`	MCP server for Claude connections

Caddy Routing

wiki.deepbluebase.xyz {
    handle /mcp*   { reverse_proxy localhost:4511 }
    handle /api/*  { uri strip_prefix /api; reverse_proxy localhost:4510 }
    handle         { reverse_proxy localhost:3002 }
}

Auth (No Supabase)

Supabase was stripped entirely. Auth uses a static API key:

Web UI: No auth (local/team access only)
API: Authorization: Bearer <WIKI_API_KEY> header
MCP: SUPAVAULT_USER_ID env var for internal identity (no token verification)

API key is stored in /home/ubuntu/wiki/.env (never expose the value).

Database

PostgreSQL in Docker at port 5433
Schema: standard supavault tables (documents, knowledge_bases, users)
No Supabase RLS — simple user_id column scoping
Connection: postgresql://postgres:deepblue_wiki_2026@localhost:5433/supavault

MCP Connection

For Claude to connect to this wiki as an MCP server:

{
  "mcpServers": {
    "deepblue-wiki": {
      "url": "https://wiki.deepbluebase.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <WIKI_API_KEY>"
      }
    }
  }
}

Adding Content

Via web UI: Visit https://wiki.deepbluebase.xyz → click "+ New Page"

Via API:

curl -X POST https://wiki.deepbluebase.xyz/api/v1/knowledge-bases/00000000-0000-0000-0000-000000000010/documents/note \
  -H "Authorization: Bearer <KEY>" \
  -H "Content-Type: application/json" \
  -d '{"filename": "my-page.md", "content": "# My Page\n\nContent here.", "path": "/"}'

Via MCP tools (from Claude): guide → list_knowledge_bases → create_note