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.
每周流程
- 飞行前:更新ha-mcp子模块(commit=会议时间戳)
- 指标:收集GitHub、PyPI、Docker统计数据
- Persona评论:所有10个角色并行分析ha-mcp
- 协调:Julz综合、解决冲突、要求跟进
- 回顾:过程健康检查
- 待办事项:具有问题链接的优先项目
- 上下文:更新跨会议上下文
- 仪表盘:重新生成指标
- 承诺与推动:所有更改均使用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页 | 低抛光,未来考虑 |
需求
- 克劳德代码CLI (
claude命令) - GitHub命令行界面(
gh)-经过认证 - Bash shell
许可证
麻省理工学院-与ha-mcp相同
