MCP Server for TYPO3 CMS CLI operations - cache management, extension handling, system health checks, and site configuration validation
Find a file
Jonas Hanisch c0daed5d4c
All checks were successful
Publish Package / publish (push) Successful in 35s
Merge develop → main: Release v2.0.0
Complete refactor with comprehensive improvements:

 New Features:
- Modular architecture (types, handlers, tool-definitions)
- 100% TypeScript type safety
- Comprehensive test coverage (38 tests)

🏗️ Architecture:
- Modular structure (types, handlers, tool-definitions, service)
- 100% TypeScript type safety
- Complete JSDoc documentation
- index.ts: 248 → 79 lines (68% reduction)

🧪 Testing:
- 38 comprehensive unit tests
- Full test coverage with Vitest
- Code coverage reporting

📦 Dependencies:
- MCP SDK upgraded to 1.20.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-10 13:16:48 +02:00
.forgejo/workflows fix: use direct authentication token in CI workflow (v1.0.5) 2025-10-07 17:09:33 +02:00
src Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00
.gitignore fix: registry configuration for scope-based installation (v1.0.1) 2025-10-07 12:34:31 +02:00
CHANGELOG.md Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00
package-lock.json Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00
package.json Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00
README.md Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00
tsconfig.json Implement TYPO3 MCP Server with CLI integration 2025-10-07 11:07:40 +02:00
vitest.config.ts Complete refactor to v2.0.0 with modular architecture and comprehensive testing 2025-10-10 13:16:41 +02:00

🚀 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