Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

bobshell 2.0.5: configured MCP servers never connect (createSession sees empty config; endpoint verified healthy via curl)

已关闭
#55 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
38/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
docker, javascript
领域
cli, tooling

调研方向

Start from the stack in ~/.bob/logs/shell/bob-shell-*.log: createSession in dist/bob.js (around the reported line) versus bob mcp list / bob mcp add-json, which already see ~/.bob/settings/mcp.json and /workspace/.bob/mcp.json. Trace how workspace startupForWorkspace / startAllSessions loads config.mcpServers versus the listing registry. Done when a server listed as enabled actually starts a session (or docs/examples only advertise the one path 2.0.5 supports). Also note add-json ENOENT if /workspace/.bob is missing.

由索引模型根据 Issue 内容生成。

描述

Summary

Bob Shell 2.0.5 never connects configured MCP servers in bob chat or bob run: the session layer's createSession reports Server '<name>' not found in config even though the configuration is present, valid, and visible to bob mcp list. The server itself is healthy — a plain curl MCP handshake from inside the same container, with the same URL and key from the same config file, completes initialize, tools/list, and tools/call successfully.

Evidence

Config installed by the bobshell entrypoint at ~/.bob/settings/mcp.json (user-global, exactly as the bobshell example documents):

{"mcpServers": {"fast_time": {"httpURL": "http://host.docker.internal:8080/servers/<id>/mcp/", "headers": {"Authorization": "Bearer <key>"}, "disabled": false}}}
  1. bob mcp list sees it: fast_time: | enabled | unknown | global.

  2. Every session attempt fails (from ~/.bob/logs/shell/bob-shell-*.log):

debug [workspace][fast_time] Starting session   (serverKey: /opt/app-root/src/.bob/settings/mcp.json::fast_time)
error [workspace][fast_time] Session failed to start — Server 'fast_time' not found in config
    at bAr.createSession (dist/bob.js:515:18139) … startServerSession … startAllSessions … startupForWorkspace
info  [workspace][fast_time] Scheduling reconnect attempt (max 3) → gives up
  1. The same config placed at the workspace path /workspace/.bob/mcp.json changes nothing — same error.

  2. Letting bob write the file itself — bob mcp add-json fast_time '<json>' (after mkdir -p /workspace/.bob) prints Added MCP server "fast_time" to /workspace/.bob/mcp.json — and the next bob run still reports the server absent from its toolset.

  3. The endpoint is healthy from inside the same container, same URL, same key (curl):

POST initialize     → HTTP 200, mcp-session-id returned
POST tools/list     → all 8 fast-time tools
POST tools/call     → {"result":{"content":[{"text":"curl-ping"}],"isError":false}}
  1. Side observation: bob mcp add-json crashes with ENOENT: open '/workspace/.bob/mcp.json' when the directory does not exist, instead of creating it.
Interpretation

Two config systems disagree inside 2.0.5: the listing/registry layer reads the mcp.json files (hence bob mcp list works and the serverKey carries the file path), but the workspace session hub passes an empty or different config.mcpServers into createSession, so no configured server can ever start. Both the documented user-global location (~/.bob/settings/mcp.json, the one the bobshell container example installs) and the workspace location were tried.

Environment
  • Image: ghcr.io/ibm/cfex-bobshell:latest (digest sha256:08dfb398…, created 2026-10-05); also reproduced on a fresh local Containerfile build resolving the same version
  • bob 2.0.5, commit 2dc180906
  • Remote MCP server: streamable HTTP, no OAuth
Ask

MCP servers configured in either documented location should connect. If only one location is supported in 2.0.5, the bobshell example and the in-CLI docs need to match it.

主要语言
Python
星标
1
派生
2
平均合并
19 小时 52 分钟
30 天内合并 PR
11

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

IBM/contextforge-examples 的其他 Issue

查看 IBM/contextforge-examples 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。