[tool] Document authenticated Streamable HTTP MCP setup
Maintainer thường phản hồi trong vòng 1 ngày
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 68/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- python
- Lĩnh vực
- documentation
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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 页面？维护者更倾向保留通用示例，还是接受一个带上述披露的可选服务例子？
- Ngôn ngữ chính
- Python
- Star
- 4.4k
- Fork
- 532
- Merge trung bình
- 18 giờ 26 phút
- Pull request đã merge (30 ngày)
- 10
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của modelscope/ms-agent
-
Skill search returns stale results after all skills are disabled or removedCó thể đã có người làm @AWUQAQ đã nhận 40 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
modelscope/ms-agent#974 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
fetch_page web tool performs unrestricted server-side HTTP fetch of agent-supplied URLs (SSRF)Có thể đã có người làm @SiyuanChenToDo đã nhận 4 ngày trước. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 45/100
modelscope/ms-agent#1018 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
modelscope/ms-agent#1011 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 68/100
modelscope/ms-agent#990 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
modelscope/ms-agent#911 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của modelscope/ms-agent
Issue tương tự
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
fossasia/visdom-dev#77 ·
Maintainer thường phản hồi trong vòng 4 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
aws-cloudformation/cfn-lint#4890 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
volcengine/OpenViking#6521 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
AstrBotDevs/AstrBot#10720 ·
Maintainer thường phản hồi trong vòng 1 ngày