How eduardokrausme/moodle-local_mcp works
Moodle MCP connects AI clients to Moodle through an MCP server, exposing permission-aware READ tools and preview/confirmation-gated WRITE tools. OAuth authorization and token resolution establish the connected identity; tool registries dispatch requests into Moodle data and administrative operations. The plugin also supports provider extensions, assignment and quiz workflows, diagnostics, audit, and site configuration. Several subsystem implementations are unsampled, so their nodes use exact directory paths and only documented or indexed relationships are shown; dashed edges indicate documented but unverified dispatch.
Main entry points: mcp_server.php MCP server · write/tool Core WRITE tools · read/tool Core READ tools · server.php MCP endpoint
Components 34
Connection and protocol
- MCP endpoint
server.php - MCP server
classes/protocol/mcp_server.php - HTTP transport
classes/protocol/http.php - OAuth authorization
oauth/authorize.php - Authorization service
classes/oauth/authorization_service.php - Token endpoint
oauth/token.php - Token service
classes/oauth/token_service.php - Connections
classes/oauth/connection_service.php - OAuth metadata
classes/oauth/metadata.php
Security and governance
- Authenticated identity
classes/security/authenticated_identity.php - Token resolver
classes/security/token_resolver.php - Scope checks
classes/security/scope.php - Capability guard
classes/security/capability_guard.php - Write confirmation
classes/security/confirmation_service.php - User access
classes/security/user_access.php - Untrusted content
classes/security/untrusted_content.php - Workflow sequence
classes/workflow/sequence.php
Moodle tool domains
- READ registry
classes/read/registry.php - WRITE registry
classes/write/registry.php - Core READ tools
classes/read/tool - Core WRITE tools
classes/write/tool - Assignment workflows
tool/assign/classes - Quiz workflows
tool/quiz/classes - Course operations
classes/course - Grades and completion
classes/grades - Question banks
classes/question
Extensions and operations
- Audit summaries
classes/audit/summary.php - Provider discovery
classes/extension/manager.php - Diagnostics
classes/diagnostics.php - Site configuration
classes/config/site_config.php
Other components
- AI client
- Moodle providers
- Moodle administrator
- Moodle platform
Connections 32
- AI client → MCP endpoint: sends MCP requests
- MCP endpoint → MCP server: dispatches to
server.php - MCP endpoint → Moodle platform: loads platform
server.php - MCP server → Token resolver: resolves bearer token
classes/protocol/mcp_server.php - MCP server → WRITE registry: loads tools
classes/protocol/mcp_server.php - MCP server → READ registry: dispatches tools
- MCP server → HTTP transport: formats responses
- OAuth authorization → Authorization service: validates authorization
oauth/authorize.php - Authorization service → Connections: uses connection data
- Token endpoint → Token service: exchanges tokens
- MCP server → Authenticated identity: uses identity
classes/protocol/mcp_server.php - MCP server → Scope checks: checks scopes
classes/protocol/mcp_server.php - MCP server → Capability guard: checks permissions
classes/protocol/mcp_server.php - MCP server → Write confirmation: gates writes
classes/protocol/mcp_server.php - MCP server → User access: checks access
classes/protocol/mcp_server.php - MCP server → Audit summaries: records outcomes
classes/protocol/mcp_server.php - MCP server → Diagnostics: logs diagnostics
classes/protocol/mcp_server.php - MCP server → Workflow sequence: serves workflow resource
classes/protocol/mcp_server.php - READ registry → Core READ tools: registers tools
- WRITE registry → Core WRITE tools: registers tools
- Core READ tools → Assignment workflows: provides assignment reads
- Core WRITE tools → Assignment workflows: provides assignment writes
- Core READ tools → Quiz workflows: provides quiz reads
- Core WRITE tools → Quiz workflows: provides quiz writes
- Core WRITE tools → Course operations: supports course changes
- Core READ tools → Grades and completion: reports learning progress
- Core WRITE tools → Question banks: supports question changes
- Assignment workflows → Untrusted content: marks model-facing content
tool/assign/classes/service.php - Provider discovery → Moodle providers: discovers providers
- AI client → OAuth authorization: authorizes connection
- Moodle administrator → Site configuration: reviews configuration
- Site configuration → Core WRITE tools: exposes approved setting writes