mistercrunch commented on code in PR #33976:
URL: https://github.com/apache/superset/pull/33976#discussion_r2175601865
##########
superset/mcp_service/README_ARCHITECTURE.md:
##########
@@ -0,0 +1,115 @@
+# MCP Service Architecture
+
+The Superset MCP (Model Context Protocol) service provides programmatic access
to Superset dashboards through both REST API and FastMCP interfaces.
+
+## Architecture Overview
Review Comment:
asked gpt to translate to mermaid, not sure if it's 100% accurate:
```mermaid
flowchart TB
subgraph MCP_Service [MCP Service]
direction TB
subgraph Flask_Stack [ ]
FS[Flask Server<br/>(Port 5008)]
FRest[REST API Endpoints]
FAPI[API Layer (api/v1/)]
FS --> FRest --> FAPI
FRest -->|• /health<br/>• /list_dashboards<br/>•
/dashboard/<id>| FRest
FAPI -->|• Authentication<br/>• Request/Response<br/>• Error handling|
FAPI
end
subgraph FastMCP_Stack [ ]
FM[FastMCP Server<br/>(Port 5009)]
FTools[FastMCP Tools]
FClient[HTTP Client<br/>(requests)]
FM --> FTools --> FClient
FTools -->|• list_dashboards<br/>• get_dashboard<br/>• health_check|
FTools
FClient -->|• Internal API calls<br/>• JSON parsing| FClient
end
subgraph Proxy_Stack [ ]
PR[Proxy Scripts]
PRRest[run_proxy.sh]
PRCore[simple_proxy.py]
PR --> PRRest --> PRCore
PRRest -->|• Local proxy<br/>for free users| PRRest
PRCore -->|• Background proxy process| PRCore
end
FAPI --> SupersetCore
FClient --> SupersetCore
PRCore --> SupersetCore
end
subgraph SupersetCore [Superset Core]
DB[Database<br/>(SQLAlchemy)]
Models[Models<br/>(Dashboard, Chart, etc.)]
DAOs[DAOs]
DB --> Models --> DAOs
end
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
