# kayedspace/laravel-mcp-bridge architecture

> Architecture diagram of the GitHub repository kayedspace/laravel-mcp-bridge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kayedspace/laravel-mcp-bridge
- Repository: https://github.com/kayedspace/laravel-mcp-bridge

## Overview

Laravel MCP Bridge exposes selected Laravel routes, resources, and operator-facing capabilities as MCP tools while retaining the application’s validation and authorization. The principal flow discovers eligible tools, builds a manifest and schemas, serves separate user and ops endpoints, then executes calls under token scopes and Laravel protections. Supporting branches cover query capabilities, remote/API integrations, token and audit operations, and administration. The README documents the product-level flow; source-index references and excerpts support only the cited internal links, so unsampled wiring is not expanded.

Main entry points: [`src/Server/GeneratedServer.php`](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Server/GeneratedServer.php) (MCP servers), [`src/Execution/ToolRunner.php`](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Execution/ToolRunner.php) (Tool execution), [`src/Sources/RouteSource.php`](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Sources/RouteSource.php) (Route source), [`src/Security/AuthorityRequirement.php`](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Security/AuthorityRequirement.php) (Authorization checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_exposure["Tool exposure"]
  node_discovery["Route discovery<br/>[RouteFilter.php]"]
  node_route_source["Route source<br/>[RouteSource.php]"]
  node_source_registry["Source registry<br/>[SourceRegistry.php]"]
  node_query["Query definitions<br/>[QueryReader.php]"]
  node_query_apply["API query<br/>[ApiQuery.php]"]
  node_schema["Input schemas"]
  node_manifest[("Tool manifest")]
end

subgraph group_runtime["Serving and execution"]
  node_servers["MCP servers"]
  node_runner["Tool execution<br/>[ToolRunner.php]"]
  node_route_exec["Route execution<br/>[RouteExecutor.php]"]
  node_other_sources["Other executors"]
end

subgraph group_security["Access and safety"]
  node_token_guard["Token authentication<br/>[TokenGuard.php]"]
  node_authorization["Authorization checks"]
  node_safety["Call safeguards"]
end

subgraph group_capabilities["Tool capabilities"]
  node_resources["Read-only resources"]
  node_integrations["API integrations"]
  node_remote["Remote MCP tools<br/>[RemoteServers.php]"]
end

subgraph group_operations["Operations"]
  node_token_ops[("Token management<br/>[McpToken.php]")]
  node_panel["Token and activity panel"]
  node_audit["Audit recording<br/>[AuditRecorder.php]"]
  node_cli["CLI operations"]
end

node_agent(("MCP client"))

node_agent -->|"connects to"| node_servers
node_servers -->|"lists tools"| node_manifest
node_source_registry -.->|"selects source"| node_route_source
node_route_source -->|"filters routes"| node_discovery
node_route_source -->|"builds inputs"| node_schema
node_query -->|"defines query"| node_query_apply
node_query -.->|"types list inputs"| node_schema
node_manifest -.->|"compiles tools"| node_source_registry
node_servers -->|"authenticates with"| node_token_guard
node_servers -.->|"dispatches calls"| node_runner
node_runner -.->|"executes route"| node_route_exec
node_runner -->|"executes other tools"| node_other_sources
node_route_exec -->|"inherits protections"| node_authorization
node_other_sources -->|"checks declared access"| node_authorization
node_authorization -->|"enforces scopes"| node_safety
node_servers -->|"serves resources"| node_resources
node_servers -->|"serves remote tools"| node_remote
node_integrations -->|"supplies documentation"| node_schema
node_panel -->|"issues or revokes"| node_token_ops
node_cli -->|"manages tokens"| node_token_ops
node_runner -->|"records calls"| node_audit

click node_discovery "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Discovery/RouteFilter.php"
click node_route_source "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Sources/RouteSource.php"
click node_source_registry "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Sources/SourceRegistry.php"
click node_query "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Query/QueryReader.php"
click node_query_apply "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Query/ApiQuery.php"
click node_schema "https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Schema"
click node_manifest "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Manifest/ManifestRepository.php"
click node_servers "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Server/GeneratedServer.php"
click node_runner "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Execution/ToolRunner.php"
click node_route_exec "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Execution/RouteExecutor.php"
click node_other_sources "https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Execution"
click node_token_guard "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Security/TokenGuard.php"
click node_authorization "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Security/AuthorityRequirement.php"
click node_safety "https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Security"
click node_resources "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Resources/ResourceRegistry.php"
click node_integrations "https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Integrations"
click node_remote "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Remote/RemoteServers.php"
click node_token_ops "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Models/McpToken.php"
click node_panel "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Http/Controllers/PanelTokensController.php"
click node_audit "https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Audit/AuditRecorder.php"
click node_cli "https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Console"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_discovery,node_route_source,node_source_registry,node_query,node_query_apply,node_schema,node_manifest,node_agent toneBlue
class node_servers,node_runner,node_route_exec,node_other_sources toneAmber
class node_token_guard,node_authorization,node_safety toneMint
class node_resources,node_integrations,node_remote toneRose
class node_token_ops,node_panel,node_audit,node_cli toneIndigo
```

## Components

### Tool exposure

- [Route discovery](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Discovery/RouteFilter.php): `src/Discovery/RouteFilter.php`
- [Route source](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Sources/RouteSource.php): `src/Sources/RouteSource.php`
- [Source registry](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Sources/SourceRegistry.php): `src/Sources/SourceRegistry.php`
- [Query definitions](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Query/QueryReader.php): `src/Query/QueryReader.php`
- [API query](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Query/ApiQuery.php): `src/Query/ApiQuery.php`
- [Input schemas](https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Schema): `src/Schema`
- [Tool manifest](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Manifest/ManifestRepository.php): `src/Manifest/ManifestRepository.php`

### Serving and execution

- [MCP servers](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Server/GeneratedServer.php): `src/Server/GeneratedServer.php`
- [Tool execution](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Execution/ToolRunner.php): `src/Execution/ToolRunner.php`
- [Route execution](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Execution/RouteExecutor.php): `src/Execution/RouteExecutor.php`
- [Other executors](https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Execution): `src/Execution`

### Access and safety

- [Token authentication](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Security/TokenGuard.php): `src/Security/TokenGuard.php`
- [Authorization checks](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Security/AuthorityRequirement.php): `src/Security/AuthorityRequirement.php`
- [Call safeguards](https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Security): `src/Security`

### Tool capabilities

- [Read-only resources](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Resources/ResourceRegistry.php): `src/Resources/ResourceRegistry.php`
- [API integrations](https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Integrations): `src/Integrations`
- [Remote MCP tools](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Remote/RemoteServers.php): `src/Remote/RemoteServers.php`

### Operations

- [Token management](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Models/McpToken.php): `src/Models/McpToken.php`
- [Token and activity panel](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Http/Controllers/PanelTokensController.php): `src/Http/Controllers/PanelTokensController.php`
- [Audit recording](https://github.com/kayedspace/laravel-mcp-bridge/blob/main/src/Audit/AuditRecorder.php): `src/Audit/AuditRecorder.php`
- [CLI operations](https://github.com/kayedspace/laravel-mcp-bridge/tree/main/src/Console): `src/Console`

### Other components

- **MCP client**

## Connections

- MCP client → MCP servers: connects to (evidence: `README.md`)
- MCP servers → Tool manifest: lists tools (evidence: `README.md`)
- Source registry → Route source: selects source
- Route source → Route discovery: filters routes (evidence: `src/Sources/RouteSource.php`)
- Route source → Input schemas: builds inputs (evidence: `src/Sources/RouteSource.php`)
- Query definitions → API query: defines query (evidence: `src/Query/QueryReader.php`)
- Query definitions → Input schemas: types list inputs
- Tool manifest → Source registry: compiles tools
- MCP servers → Token authentication: authenticates with (evidence: `README.md`)
- MCP servers → Tool execution: dispatches calls
- Tool execution → Route execution: executes route
- Tool execution → Other executors: executes other tools (evidence: `README.md`)
- Route execution → Authorization checks: inherits protections (evidence: `README.md`)
- Other executors → Authorization checks: checks declared access (evidence: `README.md`)
- Authorization checks → Call safeguards: enforces scopes (evidence: `README.md`)
- MCP servers → Read-only resources: serves resources (evidence: `README.md`)
- MCP servers → Remote MCP tools: serves remote tools (evidence: `README.md`)
- API integrations → Input schemas: supplies documentation (evidence: `README.md`)
- Token and activity panel → Token management: issues or revokes (evidence: `src/Http/Controllers/PanelTokensController.php`)
- CLI operations → Token management: manages tokens (evidence: `README.md`)
- Tool execution → Audit recording: records calls (evidence: `README.md`)
