The Anubis server orchestrates AI agent-driven development workflows through three core capabilities:
- Intelligent Guidance: Provides step-by-step rules for AI agents (like cursor, copilot, roocode) across specialized roles (Researcher, Architect, Senior Developer, Code Reviewer), including quality checklists and structured approaches for efficient task execution.
- Seamless Role Transitions: Preserves context when switching between roles, facilitates automatic task handoffs, validates transitions based on workflow progress, and maintains historical records of all role changes.
- Comprehensive Reporting: Generates interactive HTML reports with analytics dashboards (using Chart.js and Tailwind CSS), tracks workflow progress, provides performance insights, and offers both visual and JSON output formats.
Additionally, it manages complete workflow lifecycles through creation, updates, validation, and task tracking, while supporting execution of underlying MCP service operations.
Enables generation of interactive dashboards and visualizations in the workflow reports using Chart.js
Provides containerized deployment options for running the Anubis MCP server with isolated storage using Docker volumes
Built on NestJS for the backend architecture, providing enterprise-grade MCP-compliant server capabilities
Runs on Node.js runtime environment (v18.0.0 or higher) for server execution
Offers package distribution through NPM for easy installation and dependency management
Supports PostgreSQL database integration for persistent storage of workflow data
Uses Prisma ORM for database operations and model management across SQLite/PostgreSQL
Supports SQLite database integration for lightweight storage options
Leverages Tailwind CSS for mobile-responsive design in generated HTML reports
Built with TypeScript for type-safe development and integration
𓂀𓁢𓋹𝔸ℕ𝕌𝔹𝕀𝕊𓋹𓁢𓂀 - Intelligent Guidance for AI Workflows
Transform your AI agent from chaotic coder to intelligent workflow orchestrator with three powerful capabilities:
Three Pillars of Intelligent Workflow Management
Intelligent Guidance | Seamless Transitions | Repository Pattern Architecture
NPM Package • Docker Hub • Website
QUICK START
Option 1: NPX (Recommended)
Add to your MCP client config
Option 2: Docker (MCP Configuration)
For Unix/Linux/macOS (mcp.json):
For Windows (mcp.json):
INITIALIZE CUSTOM-MODES ( AGENT RULES)
Once you get the mcp server running you need to initialize the rules (custom-modes) for the agent you are using
Supported Agents: cursor
• copilot
• roocode
• kilocode
Step 1: Initialize Intelligent Guidance
Step 2: Start Your Workflow
ROOCODE Setup Example
1- install the MCP server:
2- then make sure you are on Code mode and ask it to generate the custom Anubis mode for you
Please initialize Anubis workflow rules for roocode by calling the init_rules MCP tool
3- reload the window and you should see the custom mode in the modes dropdown list. activate it and ask it to create your first task
4- also if you don't have a memory bank files, ask it to generate them for you as the first task.
Cursor Setup Example
For Cursor users, here's a complete setup example:
- Install MCP Server in Cursor:
- Open Cursor Settings (
Cmd/Ctrl + ,
) - Navigate to "Extensions" → "MCP Servers"
- Add new server configuration:
- Open Cursor Settings (
- Initialize Cursor Rules
- Make Sure the mcp server is working and active.
- ask the agent to
Please initialize Anubis workflow rules for cursor by calling the init_rules MCP tool
. - you should see a file generated at .cursor/rules with the name
000-workflow-core.mdc
- Head over to cursor rules and make sure the rules file are added and active.
Now You are ready to start you first task 🚀.
Hint: an important first step task is to generate memory-bank files Ask the agent to
Please create a task to analyze codebase and generate memory-bank files (ProjectOverview.md, TechnicalArchitecture.md, and DeveloperGuide.md)
Claude Code Setup Example
- To install the mcp server use this command
claude mcp add anubis npx -y @hive-academy/anubis
make sure you are on the poject root you want to install this into.
- To make sure it's installed correctly run
claude mcp list
you should see a server with nameanubis
. - now you will need to do a very important step:
- Download this rules markdown file Anubis Rules
- Save it inside your project for example inside a folder names
rules
and file nameanubis-rules.md
. - Then open your CLAUDE.md file and add the following:
Anubis Workflow @rules/anubis-rules.md
🏆 RECENT ACHIEVEMENTS (v1.2.11)
Repository Pattern Implementation Success 🎯
225% Completion Rate - Exceeded target goals by migrating 9 services (target: 4 services)
Successfully Migrated Services:
- ✅
workflow-guidance.service.ts
- Enhanced testability and maintainability - ✅
step-progress-tracker.service.ts
- Clean state management - ✅
workflow-bootstrap.service.ts
- Simplified bootstrap process - ✅
progress-calculator.service.ts
- Pure business logic functions - ✅
step-query.service.ts
- Flexible data access strategies - ✅
step-execution.service.ts
- Reliable execution tracking - ✅
role-transition.service.ts
- Consistent role management - ✅
execution-data-enricher.service.ts
- Efficient data aggregation - ✅
workflow-guidance-mcp.service.ts
- Standardized MCP operations
Technical Excellence Achievements 🚀
95% Type Safety - Enhanced TypeScript compliance across the entire codebase
Zero Compilation Errors - Complete elimination of TypeScript build issues
75% Maintainability Improvement - Cleaner separation of concerns through repository pattern
MCP Protocol Compliance 🤖
Multi-Agent Support - Comprehensive template system for:
- ✅ Cursor IDE - Intelligent workflow guidance integration
- ✅ GitHub Copilot - Enhanced AI assistant capabilities
- ✅ RooCode - Streamlined development workflows
- ✅ KiloCode - Advanced automation support
Performance Optimizations ⚡
Database Optimization - 434,176 → 421,888 bytes (optimized storage)
Enhanced Query Performance - Repository pattern enables efficient data access
Improved State Management - ExecutionId-based workflow tracking
🏗️ ARCHITECTURE EXCELLENCE
🏆 Recent Achievements (v1.2.11)
Repository Pattern Implementation Success
- 225% Completion Rate: Exceeded target by migrating 9 services (target: 4)
- 95% Type Safety: Enhanced TypeScript compliance across the codebase
- Zero Compilation Errors: Complete elimination of TypeScript build issues
- 75% Maintainability Improvement: Cleaner separation of concerns
Services Successfully Migrated
- workflow-guidance.service.ts
- step-progress-tracker.service.ts
- workflow-bootstrap.service.ts
- progress-calculator.service.ts
- step-query.service.ts
- step-execution.service.ts
- role-transition.service.ts
- execution-data-enricher.service.ts
- workflow-guidance-mcp.service.ts
Technical Highlights
- ✅ Zero TypeScript Compilation Errors - 95% type safety achieved
- ✅ 9 Services Migrated - Exceeded 4 service target by 225%
- ✅ 6 Repository Implementations - Complete data access abstraction layer
- ✅ 100+ Repository Methods - Comprehensive database operations
- ✅ SOLID Principles - Clean architecture with dependency injection
- ✅ Transaction Support - Data integrity across complex operations
Services Utilizing Repository Pattern
Repositories: WorkflowExecution • StepProgress • ProjectContext • WorkflowBootstrap • ProgressCalculation • WorkflowRole
🚀 Key Features
Repository Pattern Architecture
- Clean Data Access Layer: Separated business logic from data persistence
- Enhanced Testability: Mock-friendly repository interfaces
- SOLID Principles Compliance: Dependency inversion and single responsibility
- Type-Safe Operations: Comprehensive TypeScript coverage
MCP Protocol Compliance
- Multi-Agent Support: Cursor, Copilot, RooCode, KiloCode templates
- Standardized Interactions: Official Model Context Protocol implementation
- Enhanced AI Integration: Optimized for LLM workflow automation
Performance Optimizations
- Database Size Reduction: 434176 → 421888 bytes optimized storage
- Enhanced Query Performance: Repository pattern enables efficient data access
- Improved State Management: ExecutionId-based workflow tracking
CORE VALUE #1: INTELLIGENT GUIDANCE FOR AI AGENTS
Your AI agent receives step-by-step intelligent rules for every development task:
Benefits:
- 30-50% faster development with structured workflows
- 40-60% fewer defects through quality gates
- 100% MCP-compliant guidance without execution
CORE VALUE #2: SEAMLESS TASK & ROLE TRANSITIONS
Never lose context when switching between roles or continuing tasks:
Features:
- Intelligent context preservation between role switches
- Automatic task handoffs with full history
- Role-based boundaries for focused expertise
- Pause and resume workflows anytime
INTELLIGENT ROLE SYSTEM
Role | Intelligent Purpose | Key Powers |
---|---|---|
Boomerang | Strategic Orchestration | Project setup, task creation, workflow management |
Architect | System Design | Technical architecture, implementation planning |
Senior Developer | Code Manifestation | High-quality implementation, testing |
Code Review | Quality Guardian | Security validation, performance review, approval |
REAL-WORLD EXAMPLE
TECHNICAL EXCELLENCE
Enterprise-Grade Architecture:
- Backend: NestJS v11 + TypeScript
- Database: Prisma ORM + SQLite/PostgreSQL
- MCP: @rekog/mcp-nest v1.5.2
- Workflow Engine: Repository Pattern + DDD Architecture
- Runtime: Node.js ≥18.0.0
Production Ready:
- MCP-compliant architecture
- Zero execution violations
- 75% test coverage
- Sub-50ms cached responses
📚 DOCUMENTATION
- 📖 Technical Architecture - System design & patterns
- 🚀 Developer Guide - Setup & development workflows
- 🎯 Project Overview - Business context & strategy
- 🏗️ Technical Architecture - System design & patterns
🤝 CONTRIBUTING
Standards: MCP compliance • SOLID principles • Domain-driven design • Evidence-based development
LICENSE
MIT License - see LICENSE file for details.
THE ANUBIS PROMISE
Intelligent Guidance ✨ Seamless Transitions ✨ Quality Delivery
Transform your AI workflows from chaotic to intelligent. Give your agents the rules of the ancients with modern MCP-compliant architecture.
Ready to ascend? Add Anubis to your MCP config now!
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Hey @roocode community!
I'm thrilled to share a project born from my work with Roocode and the vision of an AI-powered development team: the Anubis MCP Server!
This system is heavily inspired by Roocode and designed to orchestrate an AI development workflow based on agile methodology. It simulates
Related MCP Servers
- -securityAlicense-qualityAn MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.Last updated -179PythonMIT License
- AsecurityFlicenseAqualityAn MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.Last updated -1148TypeScript
- AsecurityAlicenseAqualityA MCP server that enables human-in-the-loop workflow in AI-assisted development tools by allowing users to run commands, view their output, and provide textual feedback directly to the AI assistant.Last updated -1453PythonMIT License
- -securityAlicense-qualityA Redis-backed MCP server that enables multiple AI agents to communicate, coordinate, and collaborate while working on parallel development tasks, preventing conflicts in shared codebases.Last updated -7PythonMIT License