@customable/typo3-mcp (2.0.0)

Published 2025-10-10 13:17:38 +02:00 by jack in customable-mcp/typo3-mcp

Installation

@customable:registry=
npm install @customable/typo3-mcp@2.0.0
"@customable/typo3-mcp": "2.0.0"

About this package

🚀 typo3-mcp

Version CI Status License NPM

MCP Server for TYPO3 CLI operations with comprehensive testing - cache management, extensions, and maintenance tasks.

What's New in v2.0.0

🏗️ Complete Refactor - Modular architecture with types, handlers, and tool definitions separated 38 Unit Tests - Comprehensive test coverage with Vitest 🔒 100% Type Safe - Eliminated all any types throughout the codebase 📚 Full JSDoc - Complete documentation for all public APIs 📦 MCP SDK 1.20.0 - Upgraded to latest Model Context Protocol SDK 68% Code Reduction - index.ts streamlined from 248 → 79 lines

Features

Core Features

  • 🗑️ cache_flush - Flush all caches
  • 📋 extension_list - List all extensions
  • extension_activate - Activate an extension
  • extension_deactivate - Deactivate an extension
  • 🔧 run_command - Execute TYPO3 console command
  • 📊 get_extension_info - Get detailed extension information

Advanced Features

  • 🏥 health_check - System health check
  • ⚙️ validate_site_config - Validate site configurations
  • 📊 get_system_info - Get TYPO3 system information
  • 🔍 check_updates - Check for available updates
  • 🗄️ database_info - Get database information

Installation

npm install
npm run build

Configuration

Required environment variables:

  • TYPO3_ROOT - Path to TYPO3 installation root directory
  • PHP_BINARY - Path to PHP binary (default: php)

Usage

export TYPO3_ROOT=/var/www/html/typo3
npm start

Examples

Flush cache

{
  "tool": "cache_flush",
  "arguments": {}
}

Activate extension

{
  "tool": "extension_activate",
  "arguments": {
    "key": "news"
  }
}

Run custom command

{
  "tool": "run_command",
  "arguments": {
    "command": "backend:lock",
    "args": ["--redirect=/maintenance"]
  }
}

License

MIT

Dependencies

Dependencies

ID Version
zod ^3.23.8

Development dependencies

ID Version
@modelcontextprotocol/sdk ^1.20.0
@types/node ^22.0.0
@vitest/coverage-v8 ^3.2.4
typescript ^5.5.0
vitest ^3.2.4

Keywords

mcp typo3 cli cms
Details
npm
2025-10-10 13:17:38 +02:00
2
Customable Team
MIT
latest
20 KiB
Assets (1)
Versions (2) View all
2.0.0 2025-10-10
1.0.5 2025-10-07