Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[tool] Document authenticated Streamable HTTP MCP setup

Aperta
  • Qualcosa non va?
#1,003 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@louisss1016 ci sta già lavorando.

Dal 27/9/2026.

  • #1009 di @louisss1016 — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
68/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Python
Stelle
4.4k
Fork
532
Merge medio
18h 26m
PR unite (30g)
10

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di modelscope/ms-agent

Tutte le issue di modelscope/ms-agent

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.