starReport

starReport 是一个用于自动生成和管理指定 GitHub 仓库活跃度报告的 Node.js 工具，并通过 MCP 协议提供查询、报告生成、AI 分析和消息推送等能力。通过 MCP 服务，用户可以远程请求指定仓库的星标、提交和 Issue 等指标，触发日报或周报的生成，并获取大模型智能分析的结论。该工具还支持通过 SSE 实时返回智能分析内容，方便前端实时展示，以及兼容飞书 webhook 的问答和推送能力。要使用 MCP 服务，请先通过 MCP 配置启动 starReport 的 mcp-server，然后客户端可以通过 MCP 的请求/响应格式获取指标、生成报表并得到 AI 分析结果。若需要将分析结果自动推送到飞书群，确保 FEISHU_WEBHOOK 已正确配置且网络可达。

安装步骤如下：

1. 先安装 Node.js 和 npm，建议使用 Node.js 16+ 版本。
2. 克隆仓库并进入项目目录： git clone https://github.com/hu-qi/starReport.git cd starReport
3. 安装依赖： npm install
4. 复制并修改环境变量： cp .env.example .env 根据需要编辑 .env（包含 GitHub Token、Feishu Webhook、监控仓库、API 配置等）。
5. 启动 MCP 服务（示例，使用 MCP 配置中的 npx 方式）： npx -y star-report mcp-server
6. 本地直接运行 MCP 服务可用命令示例： node index.js mcp-server
7. 如果要本地测试或调试，请确保环境变量已正确设置，并检查日志以排查鉴权及网络问题。

提示与常见问题：

• 公开环境中请勿泄露 GITHUB_TOKEN、API_KEY 等敏感信息，建议通过环境变量管理。
• 确保 REPORT_REPOS 中列出的仓库具有访问权限，GitHub Token 需要具备读取权限。
• 若使用 Feishu 推送，请确保 FEISHU_WEBHOOK 可达且机器人已正确配置。
• MCP 参数中 API_BASE_URL、API_MODEL、API_KEY 仅在需要进行大模型分析时使用，未使用时可留空或适配默认值。
• 数据文件路径 DATA_FILE 应写入可读写的持久存储路径，避免重启后数据丢失。
• SSE 实时分析需要前端支持，后端需在对应端点开启流式传输。
• 若需要本地调试，请使用 node index.js 与 mcp-server 参数组合来启动服务。