Token导航 LogoToken导航TokenDH.com
Maxcluster MCP logo
AI代理stdio官方级别未说明来源级核验

Maxcluster MCP

MCP Server

maxcluster-mcp-server

MaxCluster MCP Server是一款用于快速部署和管理Magento 2环境的工具,支持通过AI代理或MCP客户端控制NGINX、Apache、PHP、MySQL、Redis、RabbitMQ和Elasticsearch/OpenSearch等基础设施组件。

工具数

0

提示词数

0

GitHub Stars

1

资源数

0
JavaScriptClaude基础设施管理Claude DesktopClaude

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

run-as-root

提供方

run-as-root

最后核验

2026/5/17 20:19

运行时

Node.js

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

npx maxcluster-mcp-server

详细介绍

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项基础设施运营 一键搞定:

  1. ✅ 创建MySQL数据库(自动生成凭据)
  2. ✅ 创建3个Redis实例(缓存、会话、全页缓存)
  3. ✅ 设置RabbitMQ(虚拟主机 + 用户 + 权限)
  4. ✅ 创建 Elasticsearch/OpenSearch 实例
  5. ✅ 生成完整内容 app/etc/env.php 配置
  6. ✅ 提供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 - 重启NGINX
  • nginx_reload - 重新加载NGINX配置(优雅重启)
  • apache_start - 启动 Apache(自动从 NGINX 切换)
  • apache_restart - 重启Apache
  • apache_reload - 重新加载 Apache 配置(优雅重启)
  • apache_status - 获取Apache的状态和配置

🐘 PHP(7种工具)

  • php_status - 获取PHP版本和配置
  • php_restart - 重启 PHP-FPM
  • php_reload - 重新加载 PHP-FPM(优雅重启)
  • php_install_version - 安装特定版本的PHP
  • php_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

______________________________________________________________________

📖 文档

______________________________________________________________________

🔒 安全

个人访问令牌

您的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

许可证 详情如下。

______________________________________________________________________

🙏 致谢

______________________________________________________________________

📊 项目统计

  • 44个工具 - 完整的基础设施管理
  • 8项服务 - NGINX,Apache,PHP,MySQL,Redis,RabbitMQ,Elasticsearch,OpenSearch
  • 4800多行 - 类型安全的TypeScript实现
  • 零依赖 - 仅使用MCP SDK、Axios和Zod
  • 100% 类型覆盖率 - 全面使用TypeScript,启用严格模式

______________________________________________________________________

🔗 链接

______________________________________________________________________

一键从零开始部署Magento 2生产环境。 🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接用该符号表示火箭的形象,没有直接的中文文字对应,但在网络交流中常用作表示快速前进、飞速发展等含义的符号。

目录标签

目录标签

JavaScriptClaude基础设施管理Magento2本地部署环境部署AI控制自动化工具

支持客户端

Claude DesktopClaude

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

session

运行时(runtime,运行环境)

Node.js

来源包(packageName,安装包名)

maxcluster-mcp-server

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiosession部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP