Aerith Admin MCP Server

基本能力

产品定位

Aerith Admin MCP Server 是一个用于 RBAC 仪表盘应用开发的本地服务器，特别设计用于与 Cursor IDE 集成，提供结构化的开发流程和浏览器自动化能力。

核心功能

1. 结构化开发流程：
2. USER_INSTRUCTION：定义开发任务
3. TASK_PLANNING：分解任务为子任务
4. INFORMATION_GATHERING：从各种来源收集信息
5. ANALYSIS_AND_ORCHESTRATION：分析信息并创建执行计划

6. RESULT_SYNTHESIS：执行步骤并生成报告

7. 浏览器自动化：通过 run_browser_agent 工具实现浏览器自动化任务。

8. 文件系统工具：包括目录树生成等功能。

9. Git 工具：提供完整的 Git 操作接口，如状态查看、日志、分支管理等。

10. 资源访问：支持文件和项目结构的访问。

适用场景

1. 与 Cursor IDE 集成的开发环境
2. 需要结构化开发流程的项目
3. 需要浏览器自动化能力的应用开发
4. 需要 Git 集成的开发工作流

工具列表

1. 指令管理工具：
2. create_instruction：创建新开发指令
3. get_instruction：检索现有指令

4. build_feature：高级功能构建

5. 工作流步骤工具：

6. create_task_plan：分解指令为子任务
7. gather_information：从各种来源收集信息
8. analyze_and_orchestrate：分析和创建执行计划
9. execute_step：执行计划中的特定步骤

10. generate_final_report：生成最终报告

11. 浏览器自动化工具：

12. run_browser_agent：运行浏览器代理以实现特定目标

13. 文件系统工具：

14. tree_directory：生成目录树结构

15. Git 工具：

16. 包括 git_status, git_log, git_diff, git_branch, git_checkout, git_commit, git_push, git_pull, git_add 等完整 Git 操作

常见问题解答

1. 如何检查服务器健康状态？ bash ./bin/monitor_server.py --check-only

2. 如何强制重启服务器？ bash ./bin/monitor_server.py --force-restart

3. 如何启用调试日志？ 设置环境变量 MCP_DEBUG=true

使用教程

使用依赖

1. 确保已安装 Python 和 Git
2. 安装 Playwright 用于浏览器自动化测试（可选） bash python -m playwright install

安装教程

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

2. 运行安装脚本（创建虚拟环境并安装依赖）： bash ./bin/install.sh

3. 激活虚拟环境： bash source bin/activate_venv.sh

调试方式

1. HTTP 模式（默认）： bash python server.py --port 8090

2. STDIO 模式： bash python server.py --stdio

3. 弹性模式（自动监控和重启）： bash ./bin/start_cursor_server.sh --resilient 或 bash ./bin/run_resilient_server.sh --mode http --port 8090

4. 运行测试： bash ./bin/run_tests.py -v

许可证

该项目遵循 MIT 开源许可条款。