MaxCluster MCP 服务器
在60秒内快速搭建完整的Magento 2环境 ⚡(闪电符号,常用于表示速度、活力或电力等概念)
用于MaxCluster基础设施管理的模型上下文协议(MCP)服务器。通过AI代理或直接通过MCP客户端控制NGINX、Apache、PHP、MySQL、Redis、RabbitMQ以及Elasticsearch/OpenSearch。
✨ 主要特点
- 🎯 一键式Magento 2设置 - 完整的基础设施配置与
magento_prepare_environment - 🤖 人工智能驱动的运营 - 通过Claude和其他AI代理实现自然语言服务器控制
- 🔧 44款管理工具 - 对Magento 2所有基础设施组件的全面控制
- 📋 现成可用的配置 - 自动生成
app/etc/env.php配置(或设置) - 默认安全 - 自动生成密码,无需存储凭据
🚀 快速入门
先决条件
- Node.js 20多个版本
- 使用个人访问令牌 (PAT) 的 MaxCluster 帐户
- MCP兼容客户端(如Claude Desktop等)
安装
选项1:NPX(推荐)
# Run directly with npx
npx maxcluster-mcp-server选项2:克劳德代码(一行代码)
claude mcp add maxcluster-mcp-server --env MAXCLUSTER_PAT=your_token_here选项3:手动安装
# Clone the repository
git clone https://github.com/run-as-root/maxcluster-mcp.git
cd maxcluster-mcp
# Install dependencies
npm install
# Build the server
npm run build配置
添加到您的MCP客户端配置中(例如。, ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"maxcluster": {
"command": "npx",
"args": ["maxcluster-mcp-server"],
"env": {
"MAXCLUSTER_PAT": "your_personal_access_token_here"
}
}
}
}您的第一个Magento 2环境
# In your MCP client (e.g., Claude Desktop), use:
magento_prepare_environment \
--cluster_id="C-1234" \
--web_server="srv-a" \
--db_server="db-a" \
--cache_server="cache-a" \
--queue_server="queue-a" \
--search_server="search-a" \
--search_engine="elasticsearch" \
--environment_name="Demo"结果在约60秒内完成配备即用配置的Magento 2基础设施!
______________________________________________________________________
🎯 终极工具: magento_prepare_environment
这个工具负责协调 6项基础设施运营 一键搞定:
- ✅ 创建MySQL数据库(自动生成凭据)
- ✅ 创建3个Redis实例(缓存、会话、全页缓存)
- ✅ 设置RabbitMQ(虚拟主机 + 用户 + 权限)
- ✅ 创建 Elasticsearch/OpenSearch 实例
- ✅ 生成完整内容
app/etc/env.php配置 - ✅ 提供Magento设置的分步指南
你将获得什么
🎉 Magento 2 Demo Environment Prepared Successfully!
📊 CREATED RESOURCES:
MySQL Database:
Database: db_rand_abc123
Username: user_rand_xyz789
Password: Xy9#mK2$pL4&nQ8@vB
Redis Instances:
Default Cache: Port 6379
Session Storage: Port 6380
Full-Page Cache: Port 6381
RabbitMQ:
Vhost: /magento
Username: magento
Password: auto_generated_secure_password
Elasticsearch:
Port: 9200
Heap: 2048MB
📝 COMPLETE MAGENTO 2 CONFIGURATION (app/etc/env.php):
[Complete ready-to-paste PHP configuration file]
✨ Next Steps:
1. Copy the configuration above into app/etc/env.php
2. Run: bin/magento setup:upgrade
3. Run: bin/magento setup:di:compile
4. Run: bin/magento cache:flush
5. Run: bin/magento indexer:reindex复制。粘贴。完成。 无需手动配置。
______________________________________________________________________
📚 所有可用工具
🎭 作曲编曲(2种工具)
magento_environment_check- 对所有服务进行健康检查(MySQL、Redis、RabbitMQ、搜索服务、PHP、Web服务器)magento_prepare_environment- 完成Magento 2的一次性设置
🗄️ MySQL/MariaDB(5种工具)
mysql_status- 获取数据库状态并列出所有数据库mysql_restart- 重启MySQL服务mysql_create_database- 创建带有自动生成凭据的数据库mysql_list_databases- 列出所有包含用户的数据库mysql_delete_database- 删除数据库(具有破坏性)
🔴 Redis(7种工具)
redis_status- 获取所有实例及其详细信息redis_create_cache_instance- 创建缓存优化实例(1GB,volatile-lru)redis_create_session_instance- 创建会话优化实例(512MB,持久化)redis_create_fpc_instance- 创建全页缓存实例(1GB,易失性LRU)redis_start_instance- 通过端口启动实例redis_stop_instance- 通过端口停止实例redis_flush_instance- 清除所有键(FLUSHALL)
🐰 RabbitMQ(6种工具)
rabbitmq_status- 获取服务状态、虚拟主机和用户信息rabbitmq_start- 启动RabbitMQ服务rabbitmq_stop- 停止RabbitMQ服务rabbitmq_create_vhost- 创建虚拟主机rabbitmq_create_user- 创建用户并自动生成密码rabbitmq_setup_magento- 完整设置(虚拟主机 + 用户 + 权限)
🔍 Elasticsearch(5种工具)
elasticsearch_status- 获取版本、实例数、堆内存大小elasticsearch_create_instance- 创建具有指定堆的实例elasticsearch_start_instance- 通过端口启动实例elasticsearch_stop_instance- 通过端口停止实例elasticsearch_restart_instance- 通过端口重启实例
🔍 OpenSearch(5种工具)
opensearch_status- 获取版本、实例、堆大小opensearch_create_instance- 创建具有指定堆的实例opensearch_start_instance- 通过端口启动实例opensearch_stop_instance- 通过端口停止实例opensearch_restart_instance- 通过端口重启实例
🌐 网络服务器(6种工具)
nginx_restart- 重启NGINXnginx_reload- 重新加载NGINX配置(优雅重启)apache_start- 启动 Apache(自动从 NGINX 切换)apache_restart- 重启Apacheapache_reload- 重新加载 Apache 配置(优雅重启)apache_status- 获取Apache的状态和配置
🐘 PHP(7种工具)
php_status- 获取PHP版本和配置php_restart- 重启 PHP-FPMphp_reload- 重新加载 PHP-FPM(优雅重启)php_install_version- 安装特定版本的PHPphp_uninstall_version- 卸载PHP版本php_change_cli_version- 更改默认CLI版本php_change_composer_version- 更改 Composer 版本
🛠️ 实用工具(3个工具)
intelligent_server_operation- 自然语言操作(例如,“在生产环境中重启nginx”)list_available_servers- 列出已配置的服务器映射list_clusters- 列出所有可访问的MaxCluster集群server_info- 获取详细的服务器硬件和网络信息
______________________________________________________________________
💡 常见工作流程
创建个性化服务
# Create database
mysql_create_database C-1234 db-a --description="My Store"
# Create Redis instances
redis_create_cache_instance C-1234 cache-a --description="Default Cache"
redis_create_session_instance C-1234 cache-a --description="Sessions"
redis_create_fpc_instance C-1234 cache-a --description="Full Page Cache"
# Setup RabbitMQ
rabbitmq_setup_magento C-1234 queue-a \
--vhost_name="/magento" \
--username="magento-user"
# Create search engine
elasticsearch_create_instance C-1234 search-a \
--heap_size_mb=2048 \
--description="Catalog Search"部署前的健康检查
magento_environment_check C-1234 \
--web_server="srv-a" \
--db_server="db-a" \
--cache_server="cache-a" \
--queue_server="queue-a" \
--search_server="search-a" \
--search_engine="elasticsearch"管理服务
# Restart web server
nginx_restart C-1234 srv-a
# Flush Redis cache
redis_flush_instance C-1234 cache-a --port=6379
# Restart search engine
elasticsearch_restart_instance C-1234 search-a --port=9200______________________________________________________________________
📖 文档
- 完整用户指南 - 全面的工作流程和示例
- 实施计划 - 技术架构与设计
- API发现 MaxCluster API端点参考
- MySQL 工具 - 数据库管理详情
- Redis 工具 - 缓存管理详情
- RabbitMQ 工具 - 排队管理详情
- 搜索工具 - Elasticsearch/OpenSearch 详情
- 编排工具 - 高级自动化细节
______________________________________________________________________
🔒 安全
个人访问令牌
您的MaxCluster PAT(专利申请技术或某种特定技术指标,具体根据上下文确定)很敏感。 永远不要将其提交到版本控制系统中。
推荐的设置:
# Add to your shell profile (~/.zshrc or ~/.bashrc)
export MAXCLUSTER_PAT="your_token_here"
# Or use MCP client env config
{
"env": {
"MAXCLUSTER_PAT": "your_token_here"
}
}凭证处理
- 所有密码均由MaxCluster自动生成(安全随机)
- 凭证创建后仅显示一次
- 立即保存凭据 - 之后无法检索
- 此MCP服务器不存储或记录任何凭证
______________________________________________________________________
🏗️ 建筑学
技术栈
- TypeScript - 类型安全的实现
- MCP SDK(MCP软件开发工具包) - 模型上下文协议 v0.4.0
- Axios MaxCluster API 的 HTTP 客户端
- 佐德 - 运行时验证
设计原则
- 组合优于重复 - 编排工具重用单个工具
- 全程类型安全 - 全面的TypeScript类型
- 一致的错误处理 - 带有上下文的描述性错误
- 资源清理 - 成功和失败时的适当清理工作
- 已准备好投入生产 - 全面的验证和记录
______________________________________________________________________
🤝 贡献
欢迎贡献!本项目遵循:
- 相较于大规模重写,采取渐进式改变
- 学习现有的代码模式
- 清晰的意图胜过巧妙的代码
- 全面的错误处理
查看各个工具的实现细节在 src/index.ts 以供后续模式参考。
______________________________________________________________________
📝 许可证
MIT 许可证 - 版权所有 (c) 2025 run-as-root
见 许可证 详情如下。
______________________________________________________________________
🙏 致谢
- 使用……构建 模型上下文协议
- 由……提供支持/驱动 MaxCluster(可译为“最大集群”或根据具体语境保留原英文形式,若需意译则视上下文而定) 基础设施
- 专为……设计 Magento 2 部署(们)
______________________________________________________________________
📊 项目统计
- 44个工具 - 完整的基础设施管理
- 8项服务 - NGINX,Apache,PHP,MySQL,Redis,RabbitMQ,Elasticsearch,OpenSearch
- 4800多行 - 类型安全的TypeScript实现
- 零依赖 - 仅使用MCP SDK、Axios和Zod
- 100% 类型覆盖率 - 全面使用TypeScript,启用严格模式
______________________________________________________________________
🔗 链接
- GitHub: 以root用户身份运行/maxcluster-mcp(或“在maxcluster-mcp中以root用户身份运行”)
- MaxCluster(马克斯克鲁斯特): maxcluster.de 翻译成中文可以是“最大集群.de”(注:这里的“.de”是德国的国家顶级域名,通常直接保留,不翻译)。不过,具体翻译可能还需要根据网站的实际内容和用途来调整,以更准确地传达其含义。如果“maxcluster”是某个特定项目或服务的名称,那么可能需要更具体的翻译或解释。但基于直接翻译,“最大集群.de”是一个基本的译法。
- MCP协议: modelcontextprotocol.io
- 问题:
______________________________________________________________________
一键从零开始部署Magento 2生产环境。 🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接用该符号表示火箭的形象,没有直接的中文文字对应,但在网络交流中常用作表示快速前进、飞速发展等含义的符号。
