HA-MCP管理系统

HA-MCP管理系统是一个基于AI角色的自动化管理工具,用于Home Assistant Model Context Protocol服务器,提供自动化周度评审、问题管理和GitHub集成等功能。

  • by homeassistant-ai
  • Shell
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 homeassistant-ai/ha-mcp-mgr

使用说明

HA-MCP管理系统

一个由角色驱动的管理系统 哈mcp -家庭助理模型上下文协议服务器。

概述

该存储库使用以下工具提供ha-mcp的自动每周审查 11个专门的人工智能角色,每个都专注于项目的不同方面。该系统通过模拟利益相关者会议生成优先积压。

主要特点:

  • 用于安全测试的UAT测试环境(ha-mcp-UAT-server.qc-h.net)
  • 用于测试ha-MCP功能的MCP服务器访问
  • 具有可交付成果和信念的自我进化角色
  • GitHub Pages指标仪表板
  • 全面的GitHub集成(问题、PR、讨论)
  • 通过自动分配链接到ha mcp的问题
  • 跨会议上下文保存
  • 旧文件的自动内存修剪
  • 会议结束时自动提交和推送

快速开始

# Clone the repository
git clone https://github.com/homeassistant-ai/ha-mcp-mgr.git
cd ha-mcp-mgr
git submodule update --init

# First-time setup (comprehensive bootstrap)
./scripts/first-meeting.sh

# Or for subsequent weekly reviews
./scripts/run-weekly-review.sh

仪表盘

查看指标仪表板: https://homeassistant-ai.github.io/ha-mcp-mgr/

手动重新生成: ./scripts/generate-dashboard.sh

人物角色

人物角色 重点领域 关键交付成果
Julz 协调员,最终决策 优先级框架
技术负责人 代码质量、架构 技术债务登记处
产品负责人 功能、路线图 路线图、功能请求
用户体验设计师 用户体验 用户体验指南
家庭用户 日常自动化使用 工作流模式
高级用户 电源功能 API覆盖范围
网站可靠性工程 可靠性、性能 SLO、事件日志
营销/通信 采用率、指标 指标仪表板
证券分析师 漏洞 安全检查表
社区经理 问题,文档 常见问题,问题模式
回顾 流程改进 决策跟踪

结构

ha-mcp-mgr/
├── .mcp.json              # MCP server config (UAT + custom)
├── config.json            # System configuration
├── personas/              # 11 persona folders
│   └── [persona]/
│       ├── CLAUDE.md      # Persona instructions
│       ├── beliefs.md     # Evolving observations
│       ├── deliverables/  # Active documents
│       ├── archive/       # Completed items
│       ├── notes/         # Working notes
│       └── reports/       # Weekly reports
├── backlog/
│   ├── current.md         # Active backlog
│   └── archive/           # Historical backlogs
├── meetings/
│   ├── weekly/            # Meeting notes and metrics
│   └── context.md         # Cross-meeting context
├── docs/
│   ├── dashboard/         # GitHub Pages dashboard
│   ├── TOOLING.md         # Tool reference
│   └── PERSONA-COMMON.md  # Common capabilities
├── scripts/               # Automation scripts
├── .github/workflows/     # GitHub Actions
└── ha-mcp/                # Submodule (commit = meeting timestamp)

脚本

# First-time comprehensive analysis
./scripts/first-meeting.sh

# Weekly review (subsequent meetings)
./scripts/run-weekly-review.sh

# Single persona analysis
./scripts/run-persona.sh tech-lead

# Collect metrics only
./scripts/collect-metrics.sh

# Generate/update dashboard
./scripts/generate-dashboard.sh

# Prune old persona files
./scripts/prune-old-files.sh

# Link/search issues
./scripts/link-issues.sh search "keyword"
./scripts/link-issues.sh create-mgr "Title" "Body" "label"

测试环境

UAT环境可用于安全测试:

  • 统一资源定位符: https://ha-mcp-uat-server.qc-h.net
  • 代币: demo (被替换为真实代币)

配置于 .mcp.json 作为 ha-mcp-uat.

每周流程

  1. 飞行前:更新ha-mcp子模块(commit=会议时间戳)
  2. 指标:收集GitHub、PyPI、Docker统计数据
  3. Persona评论:所有10个角色并行分析ha-mcp
  4. 协调:Julz综合、解决冲突、要求跟进
  5. 回顾:过程健康检查
  6. 待办事项:具有问题链接的优先项目
  7. 上下文:更新跨会议上下文
  8. 仪表盘:重新生成指标
  9. 承诺与推动:所有更改均使用ha-mcp提交参考

问题管理

自动分配

所有创建的问题都分配给 julienld 用于电子邮件通知。

问题链接

# Search existing ha-mcp issues
./scripts/link-issues.sh search "authentication"

# Create linked issue
./scripts/link-issues.sh create-hamcp "Feature title" "Body" "enhancement"

内存管理

自动修剪旧文件(可在中配置 config.json):

  • 报告:保留12周
  • 备注:保留8周
  • 会议文件:6个月后存档

GitHub操作

  • 仪表板.yml:会议提交时自动更新仪表板
  • 每周回顾.ml:周一提醒问题(分配给julienld)

优先级

级别 描述
P0 关键-安全、数据丢失、漏洞
第1页 高度显著的用户影响,主要功能
第2页 中等-改进、增强
第3页 低抛光,未来考虑

需求

许可证

麻省理工学院-与ha-mcp相同