STARWARCLOUD STARWAR.AI
返回市场
阿努比斯-MCP

阿努比斯-MCP

作者：Hive-Academy123 星标更新：2025-10-08
安装使用来源：spider==github.com

项目介绍

技术文档摘要

𓂀𓁢𓋹𝔸ℕ𝕌𝔹𝕀𝕊𓋹𓁢𓂀 - 智能AI工作流指导

通过三种强大的功能将您的AI代理从混乱的编码器转变为智能的工作流编排者：

<div align="center">

智能工作流管理的三大支柱

智能指导 | 无缝过渡 | 仓库模式架构

仓库模式 类型安全 干净架构

Docker拉取次数 Docker镜像大小 Docker镜像版本 MCP服务器

NPM包 • Docker Hub • 网站

<a href="https://glama.ai/mcp/servers/@Hive-Academy/Anubis-MCP"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=1982438314,2848352196&fm=3081&app=3_081&f=PNG?w=760&h=400" alt="𓂀𓁢𓋹𝔸ℕ𝕌𝔹𝕀𝕊𓋹𓁢𓂀 - 智能指导MCP服务器" /> </a> </div>

快速开始

选项1：NPX（推荐）

添加到您的MCP客户端配置

{
  "mcpServers": {
    "anubis": {
      "command": "npx",
      "args": ["-y", "@hive-academy/anubis"],
      "env": {
        "PROJECT_ROOT": "C:\\path\\to\\projects"
      }
    }
  }
}

选项2：Docker（MCP配置）

对于Unix/Linux/macOS（mcp.json）：

{
  "mcpServers": {
    "anubis": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "${PWD}:/app/workspace",
        "-v",
        ".anubis:/app/.anubis",
        "hiveacademy/anubis"
      ]
    }
  }
}

对于Windows（mcp.json）：

{
  "mcpServers": {
    "anubis": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "C:\\path\\to\\your\\project:/app/workspace",
        "-v",
        "C:\\path\\to\\your\\project\\.anubis:/app/.anubis",
        "hiveacademy/anubis"
      ]
    }
  }
}

初始化自定义模式（代理规则）

一旦您启动了MCP服务器，需要为正在使用的代理初始化规则（自定义模式）

支持的代理：cursor • copilot • roocode • kilocode

步骤1：初始化智能指导

请通过调用init_rules MCP工具来初始化[your-agent-name]的Anubis工作流规则

步骤2：启动您的工作流

使用Anubis指导开始[your-project]的新工作流

ROOCODE设置示例

Anubis MCP服务器演示

1- 安装MCP服务器：

{
  "mcpServers": {
    "anubis": {
      "command": "npx",
      "args": ["-y", "@hive-academy/anubis"],
      "env": {
        "PROJECT_ROOT": "C:\\path\\to\\projects"
      }
    }
  }
}

2- 确保您处于代码模式，并要求它为您生成自定义的Anubis模式

请通过调用init_rules MCP工具来初始化roocode的Anubis工作流规则

3- 刷新窗口，您应该在模式下拉列表中看到自定义模式。激活它并要求它创建您的第一个任务。

4- 如果您没有记忆库文件，请要求它作为第一个任务生成它们。

Cursor设置示例

对于Cursor用户，这里是一个完整的设置示例：

  1. 在Cursor中安装MCP服务器：
    • 打开Cursor设置（Cmd/Ctrl + ,）
    • 导航至“扩展”→“MCP服务器”
    • 添加新的服务器配置：
    "anubis": {
  "command": "npx",
  "args": ["-y", "@hive-academy/anubis"],
   "env": {
     "PROJECT_ROOT": "C:\\path\\to\\projects"
   }
}
  2. 初始化Cursor规则
  • 确保MCP服务器正常运行且已激活。
  • 要求代理执行请通过调用init_rules MCP工具来初始化cursor的Anubis工作流规则。
  • 您应该在.cursor/rules目录下看到一个名为000-workflow-core.mdc的文件生成。
  • 前往Cursor规则并确保规则文件已添加并激活。

现在您可以开始您的第一个任务了 🚀。

提示：一个重要的一开始的任务是生成记忆库文件 要求代理执行请创建一个任务以分析代码库并生成记忆库文件（ProjectOverview.md、TechnicalArchitecture.md 和 DeveloperGuide.md）

Claude Code设置示例

  • 使用此命令安装MCP服务器 claude mcp add anubis npx -y @hive-academy/anubis

    确保您在要安装项目的根目录中。

  • 要确保正确安装，请运行 claude mcp list，您应该能看到名为anubis的服务器。

  • 现在您需要进行一个非常重要的步骤：

    • 下载此规则markdown文件 Anubis规则
    • 将其保存在项目中的某个文件夹内，例如命名为rules的文件夹，并命名为anubis-rules.md。
    • 然后打开您的CLAUDE.md文件并添加以下内容： Anubis工作流 @rules/anubis-rules.md

🏆 近期成就（v1.2.11）

仓库模式实现成功 🎯

完成率225% - 超过目标，迁移了9个服务（目标：4个服务）

成功迁移的服务：

  • ✅ 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 - 标准化的MCP操作

技术卓越成就 🚀

95%类型安全 - 整个代码库增强了TypeScript合规性
零编译错误 - 完全消除了TypeScript构建问题
75%可维护性改进 - 通过仓库模式实现了更清晰的关注点分离

MCP协议合规性 🤖

多代理支持 - 综合模板系统用于：

  • ✅ Cursor IDE - 智能工作流指导集成
  • ✅ GitHub Copilot - 增强的AI助手能力
  • ✅ RooCode - 精简的开发工作流
  • ✅ KiloCode - 先进的自动化支持

性能优化 ⚡

数据库优化 - 434,176 → 421,888字节（优化存储）
增强查询性能 - 仓库模式使数据访问更高效
改进状态管理 - 基于执行ID的工作流跟踪

🏗️ 架构卓越

🏆 近期成就（v1.2.11）

仓库模式实现成功

  • 225%完成率：超过目标，迁移了9个服务（目标：4个）
  • 95%类型安全：整个代码库增强了TypeScript合规性
  • 零编译错误：完全消除了TypeScript构建问题
  • 75%可维护性改进：更清晰的关注点分离

成功迁移的服务

  • 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

技术亮点

  • ✅ 零TypeScript编译错误 - 达到了95%类型安全
  • ✅ 9个服务迁移 - 超过了4个服务的目标，达到225%
  • ✅ 6个仓库实现 - 完整的数据访问抽象层
  • ✅ 100多个仓库方法 - 全面的数据库操作
  • ✅ SOLID原则 - 依赖注入的干净架构
  • ✅ 事务支持 - 复杂操作中的数据完整性

利用仓库模式的服务

// 示例：使用仓库模式的服务
@Injectable()
export class WorkflowGuidanceService {
  constructor(
    @Inject('IProjectContextRepository')
    private readonly projectContextRepository: IProjectContextRepository,
    @Inject('IWorkflowRoleRepository')
    private readonly workflowRoleRepository: IWorkflowRoleRepository,
  ) {}

  // 通过抽象层减少了75%的维护
}

仓库：WorkflowExecution • StepProgress • ProjectContext • WorkflowBootstrap • ProgressCalculation • WorkflowRole

🚀 关键特性

仓库模式架构

  • 干净的数据访问层：分离了业务逻辑与数据持久化
  • 增强的可测试性：模拟友好的仓库接口
  • SOLID原则合规性：依赖倒置和单一职责
  • 类型安全操作：全面的TypeScript覆盖

MCP协议合规性

  • 多代理支持：Cursor、Copilot、RooCode、KiloCode模板
  • 标准化交互：官方模型上下文协议实现
  • 增强的AI集成：优化了LLM工作流自动化

性能优化

  • 数据库大小减少：434176 → 421888字节优化存储
  • 增强查询性能：仓库模式使数据访问更高效
  • 改进状态管理：基于执行ID的工作流跟踪

核心价值#1：AI代理的智能指导

您的AI代理为每个开发任务接收逐步的智能规则：

// 在Anubis之前：混乱无方向的编码
"创建用户认证系统" → 从哪里开始？

// 使用Anubis：每一步都有智能指导
"创建用户认证系统" →
   需求分析（研究员角色）
   系统架构（架构师角色）
   增强实施与子任务（资深开发者角色）
   质量验证（代码审查角色）
   交付准备（集成工程师角色）

优点：

  • 30-50%更快的开发，结构化的工作流程
  • 40-60%更少的缺陷，通过质量门
  • 100%符合MCP规范，无需执行

核心价值#2：任务和角色之间的无缝转换

切换角色或继续任务时永远不会丢失上下文：

// 跨越转换的无缝上下文保留
{
  "currentRole": "架构师",
  "已完成步骤": ["需求分析", "设计"],
  "上下文": {
    "决策": ["JWT用于认证", "PostgreSQL用于存储"],
    "理由": "可扩展性和安全性要求",
    "下一步": ["由资深开发者角色执行增强实施与子任务"]
  }
}
// → 切换角色而不丢失任何上下文！

功能：

  • 智能上下文保留，在角色切换之间
  • 自动任务交接，带有完整历史记录
  • 基于角色的边界，专注于专业知识
  • 暂停和恢复，随时的工作流

智能角色系统

角色智能目的主要能力
产品经理战略编排项目设置，任务创建，工作流管理
架构师系统设计技术架构，实施规划
资深开发者代码实现高质量实施，测试
代码审查质量守护者安全验证，性能审查，审批

现实世界示例

// 1. 代理接收智能指导
const guidance = await get_step_guidance({
  executionId: 'auth-system-123',
  roleId: '资深开发者'
});

// 2. Anubis提供结构化规则
{
  "guidance": {
    "步骤": "实现JWT认证",
    "方法": [
      "1. 使用Prisma创建User模型",
      "2. 使用bcrypt实现密码哈希",
      "3. 创建JWT令牌生成服务",
      "4. 添加认证中间件"
    ],
    "质量检查清单": [
      "应用SOLID原则",
      "单元测试覆盖率>80%",
      "安全最佳实践",
      "实现错误处理"
    ],
    "上下文": {
      "先前决策": ["PostgreSQL", "JWT策略"],
      "下一个角色": "代码审查"
    }
  }
}

// 3. 代理自信地执行并报告
await report_step_completion({
  结果: '成功',
  指标: {
    创建的文件数: 8,
    编写的测试数: 15,
    覆盖率: 85
  }
});

// 4. 质量交付完成！✅

技术卓越

企业级架构：

  • 后端：NestJS v11 + TypeScript
  • 数据库：Prisma ORM + SQLite/PostgreSQL
  • MCP：@rekog/mcp-nest v1.5.2
  • 工作流引擎：仓库模式 + 领域驱动设计架构
  • 运行时：Node.js ≥18.0.0

生产就绪：

  • 符合MCP规范的架构
  • 零执行违规
  • 75%测试覆盖率
  • 缓存响应时间小于50毫秒

📚 文档

🤝 贡献

# 开发环境设置
npm install && npm run db:init && npm run start:dev

# 质量检查
npm run test && npm run lint

标准：MCP合规性 • SOLID原则 • 领域驱动设计 • 基于证据的开发

许可证

MIT许可证 - 详情见LICENSE文件。

ANUBIS承诺

<div align="center">

智能指导 ✨ 无缝过渡 ✨ 质量交付

将您的AI工作流从混乱转变为智能。赋予您的代理古代规则，结合现代MCP合规架构。

准备好升阶了吗？现在将Anubis添加到您的MCP配置中！

</div>