SuperAPI AI 工具集

mcp-app-dev-setup

部署与运维

查看项目

更新于 10-15 21:37

技能介绍

用途:为 Elastic Observability MCP App 搭建或修复开发环境,数据驱动使用 Forge,对应 docs/development-with-forge.md 中的开发循环。

主要能力:确保四部分可用——Forge 克隆在 ../forge/(与 elastic-o11y-mcp/ 同级)、Forge Python venv 以可编辑模式安装(pip install -e ".[dev]")、MCP App 构建(npm install && npm run build)、集群访问(.env 中的 oteldemo-esyox GKE 凭据,通过 Forge 实时状态检查验证)。缺失或损坏则修复;用户有明确偏好(不同集群或仓库位置)时遵从。

使用方式:先定位或克隆 Forge(git clone https://github.com/elastic/forge.git ../forge);再建 venv 并安装,用 python3 -c "from forge.cli import main; print('forge cli ok')" 确认;接着在 elastic-o11y-mcp/ 执行 npm install 与 npm run build;然后配置 .env(ELASTICSEARCH_URL、ELASTICSEARCH_API_KEY、KIBANA_URL、KIBANA_API_KEY),缺失时从 .env.example 复制并向用户索取凭据,再用 Forge 查询验证;最后运行 python3 -m forge.cli mcp-app-bench 冒烟测试,预期 6 条、4 条带 ✓、2 条带 ○。日常可建议两个终端:Forge 实时会话与 MCP App harness(npm run dev、npm run harness,harness 位于 localhost:5371)。

适用场景:熟悉环境但未用过 Forge 的工程师进行环境初始化或修复。

限制:不提交 .env 或任何凭据;不修改 Forge 的 library/ 或 forge/ 目录;未经用户明确批准不运行 forge mcp-app-bench --run(会占用真实集群资源约 25-35 分钟)。无法自行修复的问题(缺凭据、仓库位置不明)只问一次,不猜测。