HA-MCP管理系统
一个由角色驱动的管理系统 哈mcp -家庭助理模型上下文协议服务器。
概述
该存储库使用以下工具提供ha-mcp的自动每周审查 11个专门的人工智能角色,每个都专注于项目的不同方面。该系统通过模拟利益相关者会议生成优先积压。
主要特点:
- 用于安全测试的UAT测试环境(ha-mcp-UAT-server.qc-h.net)
- 用于测试ha-MCP功能的MCP服务器访问
- 具有可交付成果和信念的自我进化角色
- GitHub Pages指标仪表板
- 全面的GitHub集成(问题、PR、讨论)
- 通过自动分配链接到ha mcp的问题
- 跨会议上下文保存
- 旧文件的自动内存修剪
- 会议结束时自动提交和推送
快速开始```bash
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)
脚本```bash
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=会议时间戳)
1. **指标**:收集GitHub、PyPI、Docker统计数据
1. **Persona评论**:所有10个角色并行分析ha-mcp
1. **协调**:Julz综合、解决冲突、要求跟进
1. **回顾**:过程健康检查
1. **待办事项**:具有问题链接的优先项目
1. **上下文**:更新跨会议上下文
1. **仪表盘**:重新生成指标
1. **承诺与推动**:所有更改均使用ha-mcp提交参考
## 问题管理
### 自动分配
所有创建的问题都分配给 `julienld` 用于电子邮件通知。
### 问题链接```bash
# 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相同
