Frequently Asked Questions about Aerith Admin MCP Server

Q: What is the Aerith Admin MCP Server?

A: The Aerith Admin MCP Server is a development tool designed to streamline the creation of RBAC (Role-Based Access Control) dashboards. It’s inspired by the MANUS architectural pattern and integrates seamlessly with Cursor IDE, offering a structured workflow for development tasks.

Q: What does MCP stand for in the context of the Aerith Admin MCP Server?

A: MCP stands for Model, Controller, Presenter. It reflects the server’s adherence to the MANUS-inspired architecture, which promotes a clear separation of concerns in software development.

Q: How does the Aerith Admin MCP Server integrate with Cursor IDE?

A: The server is specifically designed for integration with Cursor IDE. Cursor automatically detects the MCP server using the .cursor/mcp.json configuration, enabling developers to interact with the server’s capabilities directly from the editor.

Q: What are the key steps in the Aerith Admin MCP Server’s workflow?

A: The workflow consists of five steps: USER_INSTRUCTION, TASK_PLANNING, INFORMATION_GATHERING, ANALYSIS_AND_ORCHESTRATION, and RESULT_SYNTHESIS. These steps provide a structured approach to development, ensuring clarity and efficiency.

Q: What is the resilient mode and how do I use it?

A: Resilient mode is designed for production or extended development sessions. It automatically monitors the server’s health and restarts it if it crashes. You can enable it using the ./bin/start_cursor_server.sh --resilient or ./bin/run_resilient_server.sh --mode http --port 8090 script.

Q: What are the different modes the Aerith Admin MCP Server can run in?

A: The server can run in two modes: HTTP mode (default) and STDIO mode. HTTP mode provides a REST API and Server-Sent Events (SSE) for real-time updates, while STDIO mode is designed for integration with other tools using JSON-RPC protocol.

Q: How do I run tests for the Aerith Admin MCP Server?

A: Tests are written using pytest and located in the tests/ directory. You can run tests using the provided script: ./bin/run_tests.py -v.

Q: What are the environment variables used by the Aerith Admin MCP Server?

A: The primary environment variable is MCP_DEBUG=true, which enables debug logging. It is automatically set by activate_venv.sh. Additional environment variables can be configured as needed.

Q: Where are the logs stored?

A: Logs are stored in .aerith/logs/mcp_server.log and also output to stderr. When MCP_DEBUG=true is set, detailed debug logging is enabled.

Q: What type of data storage does the Aerith Admin MCP Server use?

A: All instructions and related data are stored in JSON files in the .aerith/instructions directory.