How paulgoffin802/project_marlin works
Marlin combines a Rayfin-hosted programme-data model and React app with a separately deployed, Entra-protected MCP service. The main user-to-result path is an MCP caller submitting a read-only search request, passing token validation, and receiving cited Orbus results; programme-context search is exposed but currently fails closed unless a user-authorized Rayfin connector is configured. The React app provides local or Fabric-backed authentication. Edges reflect the excerpts, SOURCE INDEX references, or README; no Rayfin connector implementation is shown.
Main entry points: server.ts MCP routes and tools · bootstrap.ts Auth bootstrap · rayfinClient.ts Rayfin client · main.tsx React app entry
Components 21
MCP service
- MCP routes and tools
marlin/mcp-server/src/server.ts - Service configuration
marlin/mcp-server/src/config.ts - Orbus search client
marlin/mcp-server/src/orbus.ts - Orbus Infinity
Identity and clients
- Token validation
marlin/mcp-server/src/auth.ts - Microsoft Entra
Rayfin programme data
- Programme context connector
marlin/mcp-server/src/server.ts - Programme records
marlin/rayfin/data/ProgrammeRecord.ts - Knowledge facts
marlin/rayfin/data/KnowledgeFact.ts - Rayfin data schema
marlin/rayfin/data/schema.ts
React application
- React app entry
marlin/src/main.tsx - App shell
marlin/src/App.tsx - Auth provider
marlin/src/hooks/AuthContext.tsx - Sign-in page
marlin/src/components/AuthPage.tsx - Home page
marlin/src/pages/HomePage.tsx - Auth bootstrap
marlin/src/services/bootstrap.ts - Auth service contract
marlin/src/services/IAuthService.ts - Local auth service
marlin/src/services/MockAuthService.ts - Fabric auth service
marlin/src/services/RayfinAuthService.ts - Rayfin client
marlin/src/services/rayfinClient.ts
Other components
- MCP caller
Connections 24
- MCP caller → MCP routes and tools: submits MCP requests
README.md - MCP routes and tools → Token validation: validates bearer token
marlin/mcp-server/src/server.ts - Token validation → Service configuration: checks configured claims
marlin/mcp-server/src/auth.ts - Token validation → Microsoft Entra: retrieves signing keys
marlin/mcp-server/src/auth.ts - MCP routes and tools → Service configuration: reads service settings
marlin/mcp-server/src/server.ts - MCP routes and tools → Orbus search client: dispatches Orbus search
marlin/mcp-server/src/server.ts - Orbus search client → Microsoft Entra: exchanges token OBO
marlin/mcp-server/src/orbus.ts - Orbus search client → Orbus Infinity: queries OData
marlin/mcp-server/src/orbus.ts - MCP routes and tools → Programme context connector: calls optional search
marlin/mcp-server/src/server.ts - Programme context connector → Programme records: searches records
- Programme context connector → Knowledge facts: searches facts
- Rayfin data schema → Programme records: registers entity
marlin/rayfin/data/schema.ts - Rayfin data schema → Knowledge facts: registers entity
marlin/rayfin/data/schema.ts - React app entry → Auth provider: wraps app
marlin/src/main.tsx - React app entry → App shell: renders
marlin/src/main.tsx - React app entry → Auth bootstrap: initializes auth
marlin/src/main.tsx - Auth bootstrap → Local auth service: selects local service
marlin/src/services/bootstrap.ts - Auth bootstrap → Fabric auth service: selects Fabric service
marlin/src/services/bootstrap.ts - Auth bootstrap → Rayfin client: initializes client
marlin/src/services/bootstrap.ts - Local auth service → Auth service contract: implements contract
marlin/src/services/MockAuthService.ts - Fabric auth service → Auth service contract: implements contract
marlin/src/services/RayfinAuthService.ts - Local auth service → Rayfin client: uses client session
marlin/src/services/MockAuthService.ts - Fabric auth service → Rayfin client: uses client session
marlin/src/services/RayfinAuthService.ts - Rayfin client → Rayfin data schema: types client
marlin/src/services/rayfinClient.ts