Maxcluster MCP

MCPAI代理

提供方 run-as-root · 包名 maxcluster-mcp-server

AI代理 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaude
查看接入方式

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

一句话选型结论

按资料字段整理

Maxcluster MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

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

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx maxcluster-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Maxcluster MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方run-as-root上游标注的维护方 run-as-root
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时maxcluster-mcp-server · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.1 KB
来自项目仓库与上游目录的原文,未做删改

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(推荐)```bash

Run directly with npx

npx maxcluster-mcp-server


#### 选项2:克劳德代码(一行代码)```bash
claude mcp add maxcluster-mcp-server --env MAXCLUSTER_PAT=your_token_here

选项3:手动安装```bash

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`):```json
{
"mcpServers": {
"maxcluster": {
"command": "npx",
"args": ["maxcluster-mcp-server"],
"env": {
"MAXCLUSTER_PAT": "your_personal_access_token_here"
}
}
}
}

您的第一个Magento 2环境```bash

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数据库(自动生成凭据)
1. ✅ 创建3个Redis实例(缓存、会话、全页缓存)
1. ✅ 设置RabbitMQ(虚拟主机 + 用户 + 权限)
1. ✅ 创建 Elasticsearch/OpenSearch 实例
1. ✅ 生成完整内容 `app/etc/env.php` 配置
1. ✅ 提供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 - 获取详细的服务器硬件和网络信息

💡 常见工作流程

创建个性化服务```bash

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"


### 部署前的健康检查```bash
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"

管理服务```bash

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(专利申请技术或某种特定技术指标,具体根据上下文确定)很敏感。 **永远不要将其提交到版本控制系统中。**

**推荐的设置**:```bash
# 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用户身份运行”)
  • MCP协议: modelcontextprotocol.io
  • 问题: GitHub Issues(GitHub问题)

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Maxcluster MCP 怎么安装?

在客户端按下面的安装命令接入:npx maxcluster-mcp-server。对应的包名是 maxcluster-mcp-server。装完在客户端配置里引用同一个包或端点。

Maxcluster MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Maxcluster MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Maxcluster MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Maxcluster MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Maxcluster MCP 能提供哪些能力?

资料显示能力标签包括 JavaScript、Claude、基础设施管理。具体工具清单以官方文档为准。

Maxcluster MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Maxcluster MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。