SuperAPI AI 工具集

mcp-patterns

智能体与模型

查看项目

更新于 10-15 23:24

技能介绍

用途:为构建、组合与保护 MCP 服务器提供模式与规则,基于 2025-11-25 规范(Agentic AI Foundation 维护)。适合在初始脚手架完成后,处理模式、安全与高级特性。

主要能力:按决策树覆盖服务器搭建与传输选择、OAuth 2.1 + OIDC 认证、工具组合(流水线/并行/分支)、资源缓存(TTL + LRU)、elicitation、sampling、MCP Apps 交互 UI、客户端连接、提示注入防御、零信任与哈希校验、测试调试、注册表发现及 WebMCP 浏览器工具。共 14 条规则、6 个类别。

关键建议:CLI/桌面用 stdio,生产用 Streamable HTTP(SSE 已弃用);生产优先 TypeScript;认证用 OAuth 2.1 + PKCE(S256) 与 RFC 8707;始终使用 FastMCP lifespan;错误以文本内容返回;工具信任采用显式允许列表 + 哈希校验;不通过 elicitation 索取 PII;不将客户端令牌透传给下游;大结果用 _meta["anthropic/maxResultSizeChars"] 标注。

用法与限制:Python 示例针对 v1 SDK(from mcp.server.fastmcp import FastMCP),迁移前应固定 mcp<2;fastmcp 独立分支与 mcp.server.fastmcp 不是同一包。脚手架建议用 Anthropic 的 mcp-builder 技能,Cloudflare 部署见 building-mcp-server-on-cloudflare。调试可用 claude --mcp-debug 或 export CLAUDE_MCP_DEBUG=1,并配合 MCP Inspector(npx @modelcontextprotocol/inspector <cmd>)。规范地址:https://modelcontextprotocol.io/specification/2025-11-25。具体版本行为与迁移细节以官方文档为准。