Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

[tool] Document authenticated Streamable HTTP MCP setup

Offen
  • Stimmt etwas nicht?
#1,003 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 21 Tagen

@louisss1016 arbeitet bereits daran.

Seit 27.9.2026.

  • #1009 von @louisss1016 — offen

Bewertung

Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Anfängerfreundlichkeit
68/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
python
Bereich
documentation

Rechercherichtung

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.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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 页面？维护者更倾向保留通用示例，还是接受一个带上述披露的可选服务例子？

Vorherrschende Sprache
Python
Sterne
4.4k
Forks
532
Ø Merge
20 T. 3 Std.
Gemergte PRs (30 T.)
2

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus modelscope/ms-agent

Alle Issues in modelscope/ms-agent

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.