MCP 与 Skills¶

MCP 提供远端工具，Skills 提供任务说明和资源位置。两者有独立的配置、加载与关闭行为。

常用接口¶

接口	用途
`MCPServerConfig`	连接 URL、HTTP Header、超时与远端工具过滤。
`MCPServerStatus`	查询 MCP 连接状态和注册工具。
`SkillsManager`	安装、加载、选择与删除本地 Skill。

MCP 连接¶

连接 URL、HTTP Header、超时与远端工具过滤。应在创建 Runtime 时设置。

MCPServerConfig `dataclass` ¶

Configuration for one FastMCP-connectable server.

effective_tool_timeout `property` ¶

effective_tool_timeout: int

Return the effective positive tool timeout in seconds.

查询 MCP 连接状态和注册工具。连接与关闭方法见 ToolManager。

MCPServerStatus `dataclass` ¶

Runtime status for one configured MCP server.

Skills 管理¶

安装、加载、选择与删除本地 Skill。

SkillsManager ¶

Load user-installed skills and render their prompt context.

set_skills_dir ¶

set_skills_dir(skills_dir: str | Path | None) -> None

Switch the managed skills directory and clear cached results.

install_skills ¶

install_skills(sources: Sequence[str | Path], *, replace: bool = False) -> SkillLoadResult

Install skill package directories and reload the catalog.

Every source must be a directory containing SKILL.md. Packages are copied and validated in a temporary staging directory before any installed skill is changed.

remove_skill ¶

remove_skill(name: str) -> SkillLoadResult

Remove an installed skill by its declared name and reload.

build_skills_summary ¶

build_skills_summary(skill_names: list[str] | None = None) -> str

Render skills for prompt context.

skill_names=None renders all skills, [] renders none, and a non-empty list renders only the named skills in the given order.

已加载的 Skill 元数据与路径。

Skill `dataclass` ¶

Model-visible summary for a local skill package.

加载的 Skills 与非致命错误。

SkillLoadResult `dataclass` ¶

Loaded skills plus non-fatal parse/load errors.

单个 Skill 的加载错误与路径。

SkillError `dataclass` ¶

Non-fatal error found while loading one skill file.

把可用 Skills 生成面向模型的摘要。

render_skills_summary ¶

render_skills_summary(skills: list[Skill]) -> str

Render a system-prompt XML summary of available skills.