1
Home
Virgil edited this page 2026-03-11 12:14:37 +00:00
Table of Contents
MCP
Module: forge.lthn.ai/core/mcp
Composer: lthn/mcp
Binary: core-mcp
Model Context Protocol server exposing tools for file operations, process management, ML inference, RAG vector queries, webview automation, WebSocket streaming, and metrics. The Go side implements the MCP server with a subsystem plugin architecture and MCP-to-REST bridge. The PHP side provides a Laravel MCP module with tool registration, context services, and admin UI.
Architecture
The Go Service wraps modelcontextprotocol/go-sdk/mcp.Server and adds:
- Sandboxed filesystem via
go-io.Medium - Subsystem plugin system (
Subsysteminterface) for extending tool sets - Tool registry with JSON Schema extraction and REST bridge generation
- Transport: stdio (default) or TCP (when
MCP_ADDRis set)
Tool Groups
| Group | Tools | Source |
|---|---|---|
| files | file_read, file_write, file_delete, file_rename, file_exists, file_edit, dir_list, dir_create | mcp.go (built-in) |
| language | lang_detect, lang_list | mcp.go (built-in) |
| process | process_start, process_stop, process_kill, process_list, process_output, process_input | tools_process.go |
| rag | rag_query, rag_ingest, rag_collections | tools_rag.go |
| ml | ml_generate, ml_score, ml_probe, ml_status, ml_backends | tools_ml.go (MLSubsystem) |
| metrics | metrics_record, metrics_query | tools_metrics.go |
| webview | webview_connect/disconnect, navigate, click, type, query, console, eval, screenshot, wait | tools_webview.go |
| ws | ws_start, ws_info | tools_ws.go |
Topic Pages
- Go-Architecture — Go service, subsystem API, transport, bridge
- PHP-Package — Laravel MCP module