MCP 服务器

Aerith Admin MCP Server

实现一个受 MANUS 启发的开发工作流程，用于具有浏览器自动化功能的 RBAC 仪表板应用程序，旨在通过 Cursor IDE 的 MCP 集成进行访问。

README

Aerith Admin MCP 服务器

Aerith Admin MCP (模型、控制器、展示器) 服务器实现了一个受 MANUS 启发的开发工作流程，用于具有浏览器自动化功能的 RBAC 仪表板应用程序。该服务器旨在本地运行，并由 Cursor IDE 的 MCP 集成访问。

概述

该服务器通过一个 5 步工作流程，为开发提供了一种结构化的方法：

USER_INSTRUCTION - 使用明确的目标定义开发任务
TASK_PLANNING - 将任务分解为特定的子任务
INFORMATION_GATHERING - 从各种来源收集相关信息
ANALYSIS_AND_ORCHESTRATION - 分析信息并创建执行计划
RESULT_SYNTHESIS - 执行步骤并生成综合报告

安装

# 克隆仓库
git clone https://github.com/your-org/aerith-admin.git
cd aerith-admin/mcp

# 运行安装脚本 (创建虚拟环境并安装依赖项)
./bin/install.sh

# 激活虚拟环境
source bin/activate_venv.sh

用法

服务器可以在两种模式下运行：

HTTP 模式 (默认)

python server.py --port 8090

这将在端口 8090 上启动服务器（或指定不同的端口）。该服务器提供 REST API 和服务器发送事件 (SSE) 以进行实时更新。

STDIO 模式

python server.py --stdio

此模式专为与其他工具集成而设计，使用 JSON-RPC 协议通过标准输入/输出进行通信。

弹性模式

对于生产或扩展的开发会话，您可以在弹性模式下运行服务器，该模式会自动监视服务器运行状况并在崩溃时重新启动它：

# 使用方便的脚本
./bin/start_cursor_server.sh --resilient

# 或直接使用弹性服务器脚本
./bin/run_resilient_server.sh --mode http --port 8090

弹性模式包括：

持续的健康状况监控
崩溃时自动重启
优雅的关闭处理
心跳检测和日志记录

监控

您可以使用监控脚本手动检查服务器运行状况或重新启动它：

# 检查服务器是否正在运行且健康
./bin/monitor_server.py --check-only

# 强制重启服务器
./bin/monitor_server.py --force-restart

Cursor IDE 集成

此 MCP 服务器专门设计用于与 Cursor IDE 配合使用。 Cursor 可以连接到服务器，以直接从编辑器利用其功能。

设置 Cursor 集成：

确保 MCP 服务器在 HTTP 模式下运行：python server.py --port 8090

Cursor 使用 .cursor/mcp.json 配置自动检测 MCP 服务器：

{
  "mcpServers": {
    "aerith-admin-mcp": {
      "url": "http://localhost:8090/sse"
    }
  }
}

在 Cursor IDE 中打开 Aerith Admin 项目
使用 Cursor MCP 集成 UI 与服务器交互

项目结构

mcp/
├── bin/                    # 可执行脚本
│   ├── activate_venv.sh    # 激活虚拟环境的脚本
│   ├── install.sh          # 安装脚本
│   ├── check_env.py        # 环境验证脚本
│   └── run_tests.py        # 测试运行器脚本
├── requirements.txt        # 生产依赖项
├── requirements-dev.txt    # 开发依赖项
├── server.py               # 主要 MCP 服务器实现
├── tests/                  # 测试套件
│   ├── conftest.py         # Pytest 配置和 fixtures
│   ├── README.md           # 测试文档
│   ├── test_browser_automation.py # 浏览器自动化测试
│   ├── test_core_workflow.py      # 工作流程步骤测试
│   ├── test_integration.py        # 端到端集成测试
│   ├── test_resources.py          # 资源访问测试
│   ├── test_server_modes.py       # 服务器运行模式测试
│   └── test_utils.py              # 实用函数测试
└── venv/                   # 虚拟环境 (由 install.sh 创建)

开发设置

此项目使用专用的虚拟环境进行开发：

# 运行安装脚本
./bin/install.sh

# 或手动设置环境
python -m venv venv
source bin/activate_venv.sh
pip install -r requirements-dev.txt

# 对于浏览器自动化测试
python -m playwright install

测试

测试使用 pytest 编写，位于 tests/ 目录中。

运行测试

使用提供的脚本运行测试：

# 运行除浏览器和慢速测试之外的所有测试
./bin/run_tests.py -v

# 运行并生成覆盖率报告
./bin/run_tests.py --coverage

# 包括浏览器自动化测试
./bin/run_tests.py --browser

# 包括慢速集成测试
./bin/run_tests.py --slow

# 运行特定的测试文件或模式
./bin/run_tests.py test_core_workflow