marekskopal / typo3-mcp-docs
MCP documentation plugin for TYPO3 CMS
Maintainers
Package info
github.com/marekskopal/typo3-mcp-docs
Type:typo3-cms-extension
pkg:composer/marekskopal/typo3-mcp-docs
Requires
- php: >=8.3
- typo3/cms-backend: ^13.4.24 || ^14.1.0
- typo3/cms-core: ^13.4.24 || ^14.1.0
- typo3/cms-extbase: ^13.4.24 || ^14.1.0
- typo3/cms-fluid: ^13.4.24 || ^14.1.0
- typo3/cms-frontend: ^13.4.24 || ^14.1.0
Requires (Dev)
- phpstan/extension-installer: ^1.3
- phpstan/phpstan: ^2.0
- phpstan/phpstan-deprecation-rules: ^2.0
- phpstan/phpstan-phpunit: ^2.0
- phpunit/phpunit: ^12.0
- shipmonk/phpstan-rules: ^4.0
- slevomat/coding-standard: ^8.14
README
MCP server tool documentation as a content element in TYPO3. Connects to an MCP (Model Context Protocol) server, fetches available tools with their parameters, and renders them as a browsable reference. Results are cached for 24 hours.
Features
- Automatic tool introspection via MCP protocol (v2025-03-26)
- Two display modes: full (with parameter tables) and overview (name + description only)
- Tool filtering — show only selected tools via comma-separated list
- Tools grouped by name prefix
- 24-hour response caching (TYPO3 database-backed cache)
- Bearer token authentication
- Handles both JSON and SSE (Server-Sent Events) responses
- Customizable templates and styling
Requirements
- PHP 8.3+
- TYPO3 13.4 or 14.x
Installation
composer require marekskopal/typo3-mcp-docs
Setup
Include the TypoScript Set MCP Docs in your site package or via the site configuration sets.
Content Element Options (FlexForm)
| Option | Description |
|---|---|
| MCP Server URL | URL of the MCP server endpoint (e.g. https://example.com/api/mcp) |
| MCP API Key | Bearer token for authentication |
| Display mode | full — tool name, description, and parameter table; overview — name and description only |
| Filter tools | Comma-separated list of tool names to display (empty = all tools) |
Customization
Templates
Override templates by setting custom paths in TypoScript:
plugin.tx_msmcpdocs_mcpdocs.view.templateRootPaths.10 = EXT:your_extension/Resources/Private/Templates/MsMcpDocs/
plugin.tx_msmcpdocs_mcpdocs.view.partialRootPaths.10 = EXT:your_extension/Resources/Private/Partials/MsMcpDocs/
plugin.tx_msmcpdocs_mcpdocs.view.layoutRootPaths.10 = EXT:your_extension/Resources/Private/Layouts/MsMcpDocs/
Styling
The extension includes minimal CSS. Key classes:
| Class | Element |
|---|---|
.msmcpdocs-wrapper |
Outer wrapper |
.msmcpdocs__tool |
Single tool card |
.msmcpdocs__tool-name |
Tool name heading |
.msmcpdocs__tool-description |
Tool description |
.msmcpdocs__params |
Parameters table |
.msmcpdocs__error |
Error message |
License
GPL-2.0-or-later