[tool] Document authenticated Streamable HTTP MCP setup
维护者通常 1 天内回复
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 68/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- python
调研方向
Start with docs/zh/Components/tools.md and docs/en/Components/Tools.md, then read ms_agent/tools/mcp_client.py and the ToolManager flow for headers, discovery, invocation, and cleanup. Add matching documentation for an authenticated Streamable HTTP example using mcpServers, headers, and include, with credential handling, failure boundaries, and disclosure scope clear. Done means both pages agree and the example reflects the existing interfaces without new dependencies or provider implementation.
由索引模型根据 Issue 内容生成。
描述
Description
希望为现有“工具与 MCP”指南补一个需要 Bearer 鉴权的 Streamable HTTP 使用例子。先确认品牌示例的范围，避免将外部服务硬编码成内置 provider。
当前中文 MCP 小节主要展示 SSE 地址和 exclude，英文页对应同一入口。当前 MCPClient已能把 headers 传给 Streamable HTTP transport，并由 ToolManager 注册和调度工具。对带 Key 的远端服务，读者仍需要一个把配置、凭据来源、工具范围与清理串起来的具体例子。
拟议文档范围：
- 在现有中英文页面补同一份简短例子，使用现有
mcpServers/headers/include接口；不增加 SDK 依赖、传输实现或搜索 provider。 - 明确由示例代码读取环境变量并组装 Bearer Header；不把原始 JSON 中的
${VAR}写成自动插值，也不混淆 stdio 子进程env与远端 Header。 - 先发现当前服务工具及 Schema，再选择明确工具范围；展示一个中文公开资料检索任务，保留来源和未知项，不编造返回字段或日期。
- 说明发现成功、业务调用成功是两层验收；使用现有连接清理路径，并为认证拒绝、业务
isError和超时保留失败结果，不循环重试付费调用。
关联披露：我在参与百智云 Agent Toolkit 的接入推广，希望以该服务作为可选例子。它需用户自己的账号和 Key，工具调用可能收费，参数会发送到托管服务；公开仓只描述集成，不代表服务端开源。也可以让上游页面保持通用占位例子，把百智配置放独立社区指南。
此次检查基于当前源码 a56afcc，没有调用真实 MCP 或模型，也没有宣称与已发布 PyPI 版本完成兼容验收。拟实现时先固定实际版本，以合成服务走 MCPClient → ToolManager 注册/调用/清理链路，再记录生产验证的独立边界。
这样的文档补充是否适合现有 Tools 页面？维护者更倾向保留通用示例，还是接受一个带上述披露的可选服务例子？
- 主要语言
- Python
- 星标
- 4.4k
- 派生
- 532
- 平均合并
- 18 小时 26 分钟
- 30 天内合并 PR
- 10
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
modelscope/ms-agent 的其他 Issue
-
Skill search returns stale results after all skills are disabled or removed可能已有人在做 @AWUQAQ 于 40 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
modelscope/ms-agent#974 ·
维护者通常 1 天内回复
-
fetch_page web tool performs unrestricted server-side HTTP fetch of agent-supplied URLs (SSRF)可能已有人在做 @SiyuanChenToDo 于 4 天前认领。 未关闭
难度 4/5 3-5 天 新手友好度 45/100
modelscope/ms-agent#1018 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 25/100
modelscope/ms-agent#1011 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 68/100
modelscope/ms-agent#990 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 25/100
modelscope/ms-agent#911 ·
维护者通常 1 天内回复
查看 modelscope/ms-agent 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 84/100
-
bug
难度 2/5 1-3 小时 新手友好度 77/100
AstrBotDevs/AstrBot#10720 ·
维护者通常 1 天内回复
-
cause/upstream comp/cli P2 provider/other tool/file type/bug
难度 2/5 1-3 小时 新手友好度 78/100
NousResearch/hermes-agent#143900 ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 85/100
WLAN-Pi/wlanpi-profiler#341 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 77/100
维护者通常 1 天内回复