mcp-data-platform/mkdocs.yml at main · txn2/mcp-data-platform · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
site_name: txn2/mcp-data-platform
site_url: https://mcp-data-platform.txn2.com
site_description: Composable, semantic-first MCP server platform composing DataHub, Trino, and S3 with cross-enrichment, OAuth 2.1, personas, and audit logging
site_author: Craig Johnston
repo_url: https://github.com/txn2/mcp-data-platform
repo_name: txn2/mcp-data-platform
edit_uri: edit/main/docs/

copyright: Copyright &copy; 2025 - 2026 Craig Johnston / Deasil Works, Inc.

theme:
  name: material
  custom_dir: docs/overrides
  logo: images/logo.png
  favicon: images/logo.png
  palette:
    scheme: slate
  font: false
  icon:
    repo: fontawesome/brands/github
  features:
    - navigation.instant
    - navigation.instant.progress
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.top
    - navigation.footer
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
    - content.action.edit
    - toc.follow
    - announce.dismiss

nav:
  - Home: index.md
  - Ecosystem: ecosystem/index.md
  - Getting Started:
    - Overview: server/overview.md
    - The Data Stack: concepts/components.md
    - Installation: server/installation.md
    - Configuration: server/configuration.md
    - Deployment: server/deployment.md
  - Features:
    - Tools: server/tools.md
    - Cross-Enrichment:
      - Overview: cross-enrichment/overview.md
      - Trino to DataHub: cross-enrichment/trino-datahub.md
      - DataHub to Trino: cross-enrichment/datahub-trino.md
      - S3 Enrichment: cross-enrichment/s3.md
      - Lineage Inheritance: cross-enrichment/lineage.md
    - Multi-Provider: server/multi-provider.md
    - Authentication:
      - Overview: auth/overview.md
      - OIDC: auth/oidc.md
      - API Keys: auth/api-keys.md
      - OAuth 2.1 Server (inbound): auth/oauth-server.md
      - OAuth to Upstream MCPs (outbound): auth/oauth-gateway.md
    - Personas:
      - Overview: personas/overview.md
      - Tool Filtering: personas/tool-filtering.md
      - Role Mapping: personas/role-mapping.md
    - Knowledge Capture:
      - Overview: knowledge/overview.md
      - Governance Workflow: knowledge/governance.md
      - Admin API: knowledge/admin-api.md
    - Memory Layer:
      - Overview: memory/overview.md
      - Configuration: memory/configuration.md
    - Administration:
      - User Portal: server/portal-user.md
      - Admin Portal: server/admin-portal.md
      - Admin API: server/admin-api.md
    - Operations:
      - Audit Logging: server/audit.md
      - Operating Modes: server/operating-modes.md
      - Session Externalization: server/session-externalization.md
      - Gateway Toolkit: server/gateway.md
    - MCP Apps:
      - Overview: mcpapps/overview.md
      - Configuration: mcpapps/configuration.md
      - Development: mcpapps/development.md
      - Tutorial: mcpapps/tutorial.md
  - Go Library:
    - Overview: library/overview.md
    - Quick Start: library/quickstart.md
    - Architecture: library/architecture.md
    - Extensibility: library/extensibility.md
  - Examples:
    - Gallery: examples/index.md
  - Reference:
    - Tools API: reference/tools-api.md
    - Configuration: reference/configuration.md
    - Providers: reference/providers.md
    - Middleware: reference/middleware.md
  - Support:
    - Troubleshooting: support/troubleshooting.md
    - Research:
      - MCP Gateway Landscape Survey: research/mcp-gateway-landscape-2026.md
      - MCP Gateway Live End-to-End Test: research/mcp-gateway-livetest-2026.md

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/txn2/mcp-data-platform
      name: mcp-data-platform on GitHub
  generator: false

extra_css:
  - stylesheets/extra.css

# mermaid-fullscreen.js is loaded by docs/overrides/main.html in <head>
# (intentionally before Material's bundle so it captures diagram sources).
# Do not also list it here, that would double-load the script.

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
      toc_depth: 3
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: txn2
      repo: mcp-data-platform
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

plugins:
  - search:
      separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'