ELM MCP——Bob与IBM ELM对话
停止点击“下一步门”。告诉鲍勃你想要什么。 *“Bob,用ELM中的需求、任务和测试为我构建一个端到端的跟踪服务。”* *“Bob,将此Jira史诗PDF导入DNG。”* *“鲍勃,这个团队这周在做什么?”*
⚠️ 个人激情项目。 非 IBM的官方工具。使用风险自负。IBM、DOORS Next、ELM、EWM、ETM是IBM公司的商标。
______________________________________________________________________
分3步(30秒)设置Bob
你需要:一台Mac/Linux机器、Python 3.9+和一个ELM帐户。
### 🛑 前提条件:必须在您的项目上启用DNG配置管理(CM) ELM MCP是围绕整个DNG流程构建的——模块、基线、流、可追溯性—— 所有这些都需要IBM的配置管理(CM)功能 关于DNG项目。没有CM: - 您仍然可以创建需求(在文件夹中) - 你 不能 以编程方式将需求绑定到模块中-在非CM项目上没有DNG API路径(根据IBM自己的ELM-Python-Client进行验证) - 你 不能 第5阶段的基线要求/build-project- 你 不能 使用流进行并行需求工作 如果您的DNG项目未启用CM: 请您的DNG管理员启用它(DNG管理员中的一个项目级切换;不会破坏现有数据)。大多数企业ELM客户默认打开CM。 如果您不知道CM是否已启用: 让Bob连接并尝试/build-new-project-如果目标项目中缺少CM,流程会立即告诉您。
步骤1--安装
打开终端。粘贴这个。按Enter键。
curl -fsSL https://raw.githubusercontent.com/brettscharm/elm-mcp/main/install.sh | bash该命令:
- 下载ELM MCP至
~/.elm-mcp - 询问您的ELM URL、用户名、密码(在提示符处键入——除了您自己的机器外,从不发送到任何地方)
- 自动写入Bob的MCP配置(
~/.bob/mcp_settings.json) - 验证整个过程是否端到端正常工作
第二步——完全退出+重新打开Bob
在Bob中输入Cmd+Q,然后重新打开。 Bob仅在启动时加载MCP服务器;你必须真正退出,而不仅仅是关闭窗口。
第三步——打招呼
在任何Bob聊天中,键入:
*“连接到ELM并列出我的项目。”*
Bob应该回复您的DNG项目。 你完了。 请尝试以下操作之一:
- *“为我构建一个端到端的温度转换器web应用程序。”*
- *“显示\[Module Name\]模块中的内容。”*
- *“你能做什么?”* (鲍勃打电话来
list_capabilities并显示菜单)
______________________________________________________________________
你会问鲍勃的常见问题
| 你说 | 鲍勃做什么 |
|---|---|
| *“给我造一个\[东西\]”* | 全代理流:要求→ 任务→ 测试→ 复习暂停→ 代码 |
| *“导入此Jira史诗\[粘贴文本或PDF路径\]”* | 将史诗解析为ELM工件(史诗+请求+测试+交叉链接) |
| *“显示\[module\]中的请求”* | 从DNG读取模块,总结 |
| *“团队在做什么?”* | 阅读BOB团队行动模块,总结谁做了什么 |
| *“恢复我上次的构建”* | 从您停止的地方开始进行正在进行的构建运行 |
| *“今天我受够了”* | 以队友可以阅读的最终参赛作品结束你的比赛 |
| *“更新自己”* | 从GitHub上提取ELM MCP的最新版本 |
| *“你连接了吗?什么版本?”* | 自我诊断连接状态、版本、活动运行 |
你不必记住这些。鲍勃从自然语言中弄明白了。如果你不确定该怎么办,只需键入 /getting-started 鲍勃问了一个问题,为你指出正确的起点。
______________________________________________________________________
当事情出错时
安装后Bob看不到ELM MCP:
- 您是否完全退出Bob(Cmd+Q)并重新打开?
- 跑
python3 ~/.elm-mcp/setup.py --diagnose-它用简明的英语告诉你出了什么问题
Bob要求批准每一个行动:
- 重新运行
python3 ~/.elm-mcp/setup.py--使用当前的安全自动批准工具集刷新Bob的允许列表 - 退出+重新打开Bob
模块绑定失败(“需求已创建但不在模块中”):
- 您的DNG项目未启用配置管理
- 请让您的DNG管理员启用它,或者在DNG中打开模块并手动拖动需求
- 那就告诉鲍勃 *“继续”* 构建流程重新开始
别的:
- 告诉鲍勃 *“运行elm_mcp_health”* --它将转储连接状态、版本、上次更新检查等。
- 或者打开一个问题:https://github.com/brettscharm/elm-mcp/issues
______________________________________________________________________
更新
最简单的方法: **说 *“更新自己”* 在任何Bob聊天中。** 这是一个单一的工具调用——Bob从GitHub获取最新消息,并告诉您重新启动。
或在终端:
curl -fsSL https://raw.githubusercontent.com/brettscharm/elm-mcp/main/install.sh | bash(与install命令相同——重新运行它只会更新。)
______________________________________________________________________
它到底做了什么(好奇的人)
ELM MCP是一个模型上下文协议服务器。它公开了IBM工程生命周期管理——DNG(需求)、EWM(工作项/任务/缺陷)、ETM(测试管理)、GCM(全局配置)和SCM/代码审查——作为 62个工具和10个提示 任何讲MCP的AI助手都可以拨打电话。鲍勃就是这样一个助手;克劳德代码,光标,风帆是其他。
MCP本身 零AI生成.每个工具都是针对ELM的确定性API调用。智能——编写要求、解析PDF、选择正确的模块——来自你连接的任何人工智能。
标题工作流程是 /build-new-project:
- 你给鲍勃一个简单的想法
- Bob采访你(5分钟)
- Bob提出要求;你赞成
- Bob提出任务;你赞成
- Bob提出了测试用例;你赞成
- 停止 --您在DNG/EWM/ETM中查看了所有内容
- Bob重新提取当前状态,用以下代码编写实际的应用程序代码
# Implements: REQ-005将每个文件绑定到需求的标头 - Bob标记已解决的任务,并在ETM中记录测试结果
- 最终总结:可追溯性矩阵,所有网址均可点击
每个阶段都有一个明确的用户批准门。如果每一步都没有你的签名,Bob就无法快速编写代码。
______________________________________________________________________
带上自己的AI助手
同一服务器适用于任何讲MCP的主机。 install.sh 为它检测到的每个主机写入正确的配置:
| AI助手 | 已写入配置文件 |
|---|---|
| IBM Bob | ~/.bob/mcp_settings.json (全球)+ ` |
| /.bob/mcp.json` (项目本地) | |
| 克劳德代码 | ~/.claude.json (全球)+ .mcp.json (项目) |
| VS代码副本 | .vscode/mcp.json |
| 光标 | ~/.cursor/mcp.json |
| 帆板运动 | ~/.codeium/windsurf/mcp_config.json |
______________________________________________________________________
手动安装(仅在以下情况下 curl | bash 不符合您的安全策略)
git clone https://github.com/brettscharm/elm-mcp.git ~/.elm-mcp
cd ~/.elm-mcp
python3 setup.py同样的结果,只需再迈出两步。
对于自动配置写入不起作用的气隙/锁定环境,请运行 python3 ~/.elm-mcp/setup.py --print-config。它输出JSON,准备手动粘贴到Bob的 ~/.bob/mcp_settings.json 为您的机器预先填充绝对路径。
______________________________________________________________________
隐私+凭据
- ELM密码仅存在于
~/.elm-mcp/.env在您的机器上 - 那个文件是合法的;它从未承诺过
- MCP使用您的帐户直接与您的ELM服务器进行身份验证;不涉及第三方服务
- 通过删除随时重新输入凭据
.env并重新运行setup.py
______________________________________________________________________
文件布局(如果你想检查代码)
~/.elm-mcp/
├── setup.py # Installer (this is what install.sh runs)
├── doors_mcp_server.py # The MCP server itself (62 tools)
├── doors_client.py # ELM REST client (DNG + EWM + ETM + GCM + SCM)
├── BOB.md # Instructions Bob reads automatically
├── README.md # This file
├── .env # YOUR credentials (gitignored, local only)
└── probe/ # Live-server probes + research notes______________________________________________________________________
帮助/问题/贡献
- 问题:https://github.com/brettscharm/elm-mcp/issues
- 电子邮件:brett.scharmett@ibm.com(个人能力,非IBM支持)
PR欢迎。探头在 probe/ 记录现场ELM API表面;新工具应遵循中的模式 doors_client.py (使用ETag获取→ 修改→ PUT和If Match用于更新;服务提供商发现→ POST到创建工厂进行创建)。
______________________________________________________________________
与您的团队分享
复制粘贴就绪的广告语:
🤖 榆树MCP --从Bob(或任何AI助手)驱动IBM DOORS Next、EWM和ETM,而不是在web UI上点击。 30秒后安装: `` curl -fsSL https://raw.githubusercontent.com/brettscharm/elm-mcp/main/install.sh | bash `` 重新启动Bob。说 *“连接到ELM并列出我的项目。”* 62个工具,10个提示。读/写要求(富文本+表格+图像),使用可追溯的代码端到端构建完整的项目,导入Jira epics,查看您的团队在做什么。完整详细信息:https://github.com/brettscharm/elm-mcp ⚠️ 个人激情项目——不是IBM的官方工具。